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Dealer Inquiries Accepted 
CaU 800/828-6637 



Remember the expression "A picture is worth a 
thousand words?" Take a second look. The Shanner 
Planner"* is the first ever tioll system portfolio created 
specifically for the computer user. Designed to 
address the individual needs of the computer in- 
dustry, The Shanner Planner is tastefully constructed 
of long lasting, durable, textured nylon (tl's the 
in thing today) to maintain its smart appearance 
over time, 



SHAHNER INTERNATIONAL CORP. 



See the local authorized dealer nearest you or use this SPEEDYorder form. 

Please send me Shanner Planner(s) at $39.95 each, plus 

S6.00 postage & handling. (CA residents add S2.60 per Plannerfor sales lax.) 
Please Indicate method of payment and media size required: 

Media Size 
G Check D Money Order D VISA D Mastercharge D 3Vz" □ 5V.i" 
Orders may be sent to: 

Shanner International Corp. 

453 Ravendale Drive, Mountain View, CA 94043 

Account No. . 



Address 

Cily _^ . State Zip _ 

Prices subject to change without notice. 

For direct orders: 

Call our HOTLINE 1-800-423-8673. In CA 1-800-626-9273. 




Personal Pascal for Atari ST Computers 

Just as Craftsmen Need Precision Tools... Programmers Demand Precision Software 



Now OSS is proud to present 
Personal Pascal, the first Pas- 
cal for Atari ST computers that 
is destined to be the best! 
Trust OSS to start you off in this 
efficient and popular language 
with a complete programming 
system — everything you need 
to start writing programs today! 
Editor, Compiler, Linker, GEM 
Libraries, and more. 

Enjoy a language that starts 
with the international (ISO) 



standard and then adds dozens 
of expert features. Compatible 
string handling, powerful de- 
bugging options, special code 
optimizer — and of course, the 
famous OSS support! 

Why wait? Purchase a copy of 
Personal Pascal and maximize 
not only the potential of your ST 
computer, but yours as well. 



Optimized Systems Software, Inc. 

1221B KenUvood Avenue, San Jose. California 95129 (408) 446-3099 



Also available from OSS: 
Personal DiskKit — A disk 
utility complete with full source 
code. 

Personal Prolog — Discover the 
world of logic programming with 
this language of the future. 
For more information on OSS's 
complete line of ST software, 
call or write for a free brochure. 

Atari ST Computers are a trademark of Atari 
Corporation. Personal Pascal'" is a trade- 
mark ofO.S.S., Inc. 
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STart welcomes submissions, 
hard copy printouts of article 
as well as disk files on ST coi 
will be returned if seif-oddre 
is supplied, SJaut assumes nc 
unsolicited editortoi moteriol. 

No part of this publication may be reproduced, 
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form or by any means, electronic, mechonicol, 
photocopying, recording, or otfierwise, without the 
prior written permission of the publisher. 
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t Antic Publishing are serious 
aiiout the new Atari ST computers, 
and we know you are too. That's why I'm 
pubhshing START, the ST Quarterly 
ST owners need a powerful publication, and that's what START is. 

Let me tell you who we think you are, then you can look through this issue 
of START and see if it meets your needs. 

You are probably well experienced with computers — -used them in school or 
at your office — maybe you have owned one before. The important thing is that 
you have carefully considered the ST computer and concluded that it is the best 
buy for you. This is the machine you've been waiting for, and now you've got it! 

Because you are experienced, you know you need the support of an active 
community- — -retailers, services and product manufacturers — as well as tech- 
nical information and creative applications. You know there is a lot to learn — 
about the machine and how to use it. You know there is a lot to share — -proud 
conquests and baffling problems. For this you need a publication that has the 
right stuff in it. 

We think you v/ant high-end information that requires a good grounding on 
your part both in computer fundamentals and practice. We think you want 
substantial articles and programs that will repay your investment of time and 
money in the ST and in START. 

Is that you? If it is, take a look at our lineup this time; tough, strong pieces 
by the best ST minds around, backed up by six programs on the bound-in 
disk— no listings to type in, wc think you're beyond that. (Note: some copies 
of START are sold without disk as a convenience to the trade and others with- 
out ST computers. If this copy does not contain a disk, you can order it for 
$10.95, plus 32.00 for postage and handling, from START DISK, 524 Second 
St., San Francisco, CA 94107.) 

Because START is quarterly, we have the time to get, edit and present the 
best material for you, and you don't have to spend a formne for complete ST 
coverage! Here's the deal: you can buy START on the newstand for $14.95 per 
issue (with disk), or subscribe to START for $59.95 (4 issues) and also receive 
12 issues of Antic, that include the ST Resource. That means an additional 
monthly infusion of 30-40 pages of ST editorial material and programs m 
Antic. 

Finally, we invite you masters of the 68000 to bend your brains in our di- 
rection. Information on article and program submissions can be found in The 
Dialog Box in this issue. The best ST articles and programs will always find a 
privileged place in START. 

James Capparell 

Publisher 
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START SUBMISSIONS 

Programmers.' Developers, hob- 
byists, students, gamesters, 
hackers: share the wealth, . . . of infor- 
mation. We have a new machine to 
explore, a lot to puzzle out. STart 
wauls to hear from you, be it in a let- 
ter, article or program. This is your 
forum, so take advantage of it. We're 
looking for those new (discoveries, 
technical tips, tutorials and bugs. 

Submissions and queries are very 
welcome. Please send correspondence 
to tlie address below. Submissions 
should be on both printed hard copy 
and on 3 1/2-inc/i, single-sided ST 
disk. (We prefer double-line spacing 
for articles; very long programs need 
not be placed on hard copy.) A cover 
letter, briefly describing your pro- 
gram or article, is suggested. If you 
wish your material returned, please 
include a self-addressed, stamped 
mailer. STart is looking for original 
in/ormalioii and will be unable to 
publish articles or programs wfiicli 
bflve appeared in user group newslet- 
ters or on bulletin board systems. 

Our address is: 

STart Editors 

c/o Antic Publishing 

524 Second Street 

San Francisco, CA 94107 

ST LANGUAGES 

I am very interested in learning C but 
do not know which compiler would be 
best for me. I want to write good 
entertainment and/or role-playing, 
Ultima-type games. Okay, 1 may be 12- 
years old, but I am serious. Which 
compiler should I get? 
Tim Gallo 
Via CompuServe 



1^ Many languages are available for the 
ST, including afew esoteric rarities such 
as Modula-2 and Personal Prolog. STari 
considers C the most flexible language for 
the ST, but not necessarily the easiest to 
use. Aicyon C, included in the developer's 
toolkit from Atari, is difficult to use and 
slaw to compile. Unfortunately, Aicyon 
was the first and has therefore established 
certain standards. Of the several other C's 
available on the ST, MegaMax is the easi- 
est to use, but it is also the most expensive 
(for more details, see "Practical Software 
for the Non-Developer," in this issue). 
GST-C is more affordable and is nearly as 
friendly as MegaMax, though not as fast. 
But CST-C has no floating point and its 
link system is incompatible with Aicyon 
C's, Otiier versions offer greater incom- 
patibility with Aicyon, or greater diffi- 
culty of use. 

If you arc creatingfrom scratch, in- 
compatiblity is not a problem. But if you 
are dealing with a program written for Ai- 
cyon C, sued as a magazine listing, you 
are sure to run into trouble. At STart we 
have decided to make our C listings com- 
patible with Aicyon C because a standard 
of some kind must be established. In most 
cases, our listings will also work with 
MegaMax C. Some changes may be 
needed for GST-C or Lattice (usually for 
the linkage). Haba Hippo C will have 
many problems. 

If you don't insist upon C, we recom- 
mend O.S.S.'s Personal Pascal. Pascal is 
very close to C and Personal Pascal is the 
only language currently available with 
full, understandable documentation on the 
GEM AES and VDl calls. With any other 
language (excepting Aicyon C) you will 
need to buy the Abacus ST books, num- 
bers 2, 3, and i. ■ 



WHERE'S 
MY 

DISK? 




^^ ^KARJ is a magazine with its 
^^ ■ programs on disk. Normally 
^W ■ you will find the disk bound 
Into the magazine and for sale on the 
newsstands at a combined price of 
$14.95, 

But we know that some of you ST en- 
thusiasts want to read ST-^rt first, with- 
out paying $14,95, so we have provided 
a limited number of copies without disk 
for $4,00 each. 

If this is your situation, you can com- 
plete your copy of this collector's issue of 
STart by ordering the companion disk 
direct from us, for $10,95 plus $2.00 
shipping and handling. See the handy 
order form . 
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\^ hristopher Chabris is studying 
computer science in the Division of 
Applied Sciences ai Harvard Univer- 
sity. His fields of interest include ar- 
tificial intelligence, analysis of 
algorithms, and parallel processing. 
Christopher is a regular contributor to 
Antic magazine and other Atari-ori- 
(jnted publications. He has extensive 
experience with 68000 systems pro- 
gramming, and his "Introducing 
68000 Assembly Language" appeared 
in the November 1985 issue of Antic. 

An internationally- ranked chess 
player, Christopher has represented 
the United States in competitions 
abroad and is among the top 50 play- 
ers in the United States under 21 
years of age. Currently, he is develop- 
ing ST software and writing a book 
on artificial intelligence programming 
in Pascal. 

Tv^enty-two-year-old Joe Chiazzese, to- 
gether with his partner Alan Page, is 
putting the finishing touches on 
Flash, an ST terminal program. He 
was born and raised in Montreal, 
Quebec, After completing high school, 
Joe attended Dawson College with 
every intention of becoming a nuclear 
physicist. But, during his first year, he 
purchased an Atari 800 and quickly 
decided he preferred programming. 
He moved to Toronto where he en- 
rolled at DeVry Institute of 
Technology 

Joe wrote many small public do- 
main programs with the 8-bit Atari, 
but nothing of commercial value. 
When the 520 ST was announced, he 
immediately bought one. At the end 
of September 1985, he met Alan Page; 
Flash is their first major project. 



Corey Cole joined the "micro revolu- 
tion" shortly after the introduction of 
the Apple II. He has been program- 
ming professionally since 1975, and 
creating word processing and typeset- 
ting software since 1981, When Atari 
announced the 520ST in January of 
1985, Corey saw a new revolution be- 
ginning, and decided to join the 
cause, 

Corey is the president of Visionary 
Systems, which is currently develop- 
ing state-of-the-art word processing 
and persona! publishing products for 
the ST. Like the Atari ST, Visionary's 
products will feature "power without 
the price." Corey shares his San Jose, 
CA home with his wife Lori, two 
dogs, and an assortment of computers 
and musical instruments. Not content 
with traditional software marketing 
practices, Corey and Lori expect to 
■ have their own small computer user 
in late June, 

Jim Dunion worked for the old Atari, 
first in the Software Development 
Support Group and later in Alan 
Kay's research group. While there, he 
authored DDT — Dunion's Debugging 
Tool, probably the best known debug- 
ger for the 8-bit Atari, 

Jim has worked in the computer 
field since the eariy days of micro- 
processors and was a founder of a 
small retail computer store in Atlanta, 
GA, that eventually became Peachtree 
Software, At present, he is at The Sys- 
tem Works in Redmond, WA, where 
he is working on the user interface 
portion of a maintenance planning 
and control system. 

Tom Hudson is the creator of DEGAS, 
the popular ST paint program. Cur- 
rently a freelance software developer, 
Tom was head of programming for 
ANALOG Computing magazine from 
1982 to 1985, He first worked with 
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computers on an IBM 1620 during his 
high school years. While earning an 
Associate of Science degree in data 
processing, Tom taught non-technical 
people how to program microcom- 
puters, and from 19784982 he 
worked as a programmer/operator at a 
savings and loan association while 
earning his Bachelor of Science degree 
in data processing. 

After leaving ANALOG in the 
summer of 1985, Tom wrote DEGAS 
for Batteries Included, He lives in 
Mission, Kansas where he is hot at 
work completing CAD-3D, a three-di- 
mensional graphics system for the ST. 
If you want to talk to Tom, you can 
often find him on-line on the 16-bit 
section of CompuServe's SIG*Atari, 
where he recently became a SYSOP. 

Tom Jeffries has been a professional 
musician for more than 15 years. He 
has played first trumpet with the St, 
Paul Chamber Orchestra and the San 
Jose Symphony; he has recorded with 
Dave Brubeck and numerous TV and 
radio shows. Though members of his 
family have been involved in comput- 
ers since the 1950's, Tom managed to 
avoid serious work with them until 
1984, when he became interested in 
the Commodore 64's SID chip. 

Tom currently heads a company 
called Singing Electrons, developing 
and translating soundtracks and mu- 
sic-related software for microcom- 
puters. He has written programs for 
most available micros, including the 
Atari ST, the entire Atari 8-bit line, 
the Amiga, the Apple U, the Com- 
modore 54, and the IBM PC. In addi- 
tion to the ST version of MIDImagic, 
mentioned in his article, Tom is cur- 
rently completing an ST version of CZ 
PATCH, for Dr. T's Music Software, 

Daniel Matejka has been programming 

professionally, on and off, for seven 



years. Three years ago, in Colorado 
Springs, he stumbled upon the crowd 
that makes and markets DB Master, a 
best-selling database on the Apple II 
which has been incarnated on several 
other machines as well. Dan v/as par- 
tially responsible for the IBM PC and 
Atari ST versions of that program. 

Dan now lives in Fairfax, CA. He 
has since branched out and is writing 
programs independently Antic's Disk 
Doctor is his, and Antic's forthcoming 
game, Red Alert, is the result of a col- 
laboration with Stanley Crane, one of 
the original DB Master programmers. 

Tim Oren is a familiar name among the 
community of ST developers. He is 
the author of ST PROFESSIONAL 
GEM, a biweekly GEM programming 
column available on Antic's Online 
CompuServe edition, and was a mem- 
ber of the original. Digital Research 
GEM development team. 

At Digital Research, Tim designed 
and implemented the GEM Resource 
Construction Set, and worked on 
parts of the AES and the Desktop. 
Since leaving DRI, he has been the 
GEM interface designer for Knowl- 
edgeSet (formerly Activenture), which 
is planning to release a CD ROM- 
based encyclopedia for the Atari ST. 
Tim has a master's degree from Mich- 
igan State University. In his free time, 
he enjoys hiking throughout the 
glorious Monterey countryside, where 
he currently resides. 

David Small was a longtime contributor 

to the now defunct Creative Comput- 
ing magazine and a frequent contrib- 
utor to Antic. His last piece 
demonstrated how to read and write 
IBM disks from the Atari ST (ST Uses 
IBM Disk Files, Antic, November 
1985). David has published three 
books and written over a hundred 
magazme articles. He and his wife, 



Sandy, both have Computer Science 
degrees from Colorado State Univer- 
sity They are co-authors of "Guide- 
book for Winning Adventures" (Baen 
Enterprises, NY, NY), and their fourth 
book is due to be pubHshed January. 
1987. 

Though their two children purpor- 
tedly keep them busy changing di- 
apers, the Smalls have, nontheless, 
found time to complete their latest 
project: tricking the Atari ST into 
thinking it is a Macintosh. David has 
worked for several computer com- 
panies, and today is a consultant, 
freelance writer, and diaper changer 
He briefly existed in San Jose, spent 
some time in exile in Austin, Texas, 
and now lives in Denver, Colorado. 

Russ Wetmore attended Morehead State 
University with the idea of receiving a 
degree in music composition, but 
somehow ended up in the computer 
field. Maybe it was the influence of 
his father, who designs flight simulat- 
ors for the military In any case, Russ 
started in the late 1970's as a pro- 
grammer with Adventures Interna- 
tional, the Scott Adams company 
famous for its puzzling text adven- 
tures. While there, Russ wrote his 
first big hit, Preppie, memorable as 
one of the hrst Atari programs to use 
the vertical blank interrupt to support 
continual background music. 

Russ then went off to form his 
own company. Star Systems. There, he 
wrote the integrated software package 
HomePak, which was snapped up by 
Batteries Included. He has since been 
kept busy adapting HomePak to most 
available microcomputer brands. The 
ST version should be available very 
soon, Russ is also a SYSOP on Com- 
puServe's SIG Atari, and author of the 
terminal software for the 8-bit Atari's 
new XM30I modem, ■ 
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Be a Hero To Winnie The pooh 



Last night the blustery wind came up and 
mixed up everything in the Hundred Acre 
Wood. If you can find tlie lost articles, 
like Pooh's honey pot and Eeyore's tail, and 
return them to their rightful owners, the 
characters in the Hundred Acre Wood will give a 
Hero Party in your honor! 

Children can play this adventure game over and 
over again, and never play the same game twice. 
The "Save Game" feature allows players to 
work on onfe^aa maJEuaiQig than one sitting. 




6 and up. 

Iii';<(liii|; cimiprelieiislon. logical thinking, niiip ri':iiliii|; skills I 
I'nr .Apple II+/Ile/llc, IBM, Atari ST, Cnmmiidori' and Amiga. [ 

At software dealers evervwtierc.or ail toll free 
H0l)-423-5290 oulshk CA. 86o-452-6000 insicli- CA. 

delightful graphics and a?] intriguing challenge, " 
- Compute! magazine 



Look For Winnie The Pooh At These Fine Dealers: 
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p Charlotte 
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ECX Computer Co, 
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VIRGINIA 
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East Delroll 
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Systems 
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Fairfax Computer 
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KENTUCKY 


313-445-2983 




Geneva 


Specialty Cash 


Products 




Sodware Source 


Software Plus 


NEW JERSEY 
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Fairfax 


FLORIDA 


Louisville 


Breton Village 
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Computer Dome 
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703-691-1930 
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704-322-4884 
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Software City 
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Software City 
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Computer Service 
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201-2B7-09Ba 
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Federal Way 
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Computer World 
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Castle Communications 
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47th Street Photo 


OHIO 
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Lansing 


Computer Centres 




Magic One Compute 


Take-A-Byle, Inc. 
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Fairfield 
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Hands On Com put ar 
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Computer Depot 
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HAWAII 


Mt, Clemens 


Software Station 


Computer Supplle 
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Dalai 
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313-792-1717 
Command Computer 
Systems 
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Soil ware Spectrum 
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51B-372-4491 
Sollware Cily 

Syracuse 


Elyrla 

Micro Wave liAaglc 


WISCONSIN 
Starting Computers 
Brooklield 


PC PrlcebuHlers 


207-854-1155 




Fairfield 


414-781-4444 


Honolulu 
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KahLilul 


MARYLAND 

Company 

Tows on 
301-337-2733 

MASSACHUSETTS 


3 13-573-81 30 

Basic Bits & Bytes 

Westland 

313-595-3171 


Family 
Computer Centres 

Ridgewood 


315-445-2577 

Thruway 
Computer Center 

Thruway Shopping 
Canter Pfaza 

Walden 

914-778-3535 
J, J. Stocker Co. 


513-874-6560 
OREGON 
Creative Computers 


The Software Shop 

Fond Du Lac 
414-921-8448 
Comp'U"Sorv 


B08-877-7522 
Dstal 
Pearl City 

808-487-5411 


MINNESOTA 
Wizard's Work 
New Hope 


201-445-7503 
Family 
Computer Centres 
Soulh Orange 


Beavarton 
503-644-1160 

Ruth Kahn Co. 
Band 


414-649-8326 






612-545-2136 






503-388-4807 




IDAHO 


Nichols Electronics 












PittsflQld 


MISSOURI 


NEW tilEXICO 




PENNSYLVANIA 




Siokoa Bros. 

Boise 

208-323-1666 


413-443-2568 






NORTH CAROLINA 


Soltware Hut 




The Bit BucKet 
West Newion 




Albuquerque 


Selective Software 


Philadelphia 






417-678-4623 


505-247-4175 


Ardan 








817-964-3080 






704-684-9987 
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SHIFT INTO... 




ONLY SS49 
(10 MegaByte System) 




The necessary Peripheral for any serious Atari ST user." 



Tom Hudson 

Author of Batteries Included's 
Best Selling DEGAS program. 



Improves the ST's overall performance (3-20X improvement 
on disk transfers) 

Atari"^" compatible with software and other DMA Buss Devices 

Includes Hard Disk format and partition utilities 

High-Performance 20, 30, and 60MB SupraDrives are 
also available 

"The 10MB SupraDrive is available only directly from Supra Corp. Higher 
capacity Drives are available from your local dealer. 



Supra Corporation 

1133 Commercial Way / Albany, OR 97321 / (503)967-9075 



MUSIC ON THE ST 



SEQUENCER 




b y T e 



Jeffries 



■ alee advantage of your ST's built-in MIDI interface. 
This Simple Sequencer lets you record, save to disk, 
and playback music created on your synthesizer Cre- 
ates music files compatible with MIDIMagic, from 
Q-R-S Music Rolls. Pertinent files may be found on 
your START disk within the folder labeled MIDISEQR 
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the basic principles of a sequencer, k is 
compatible with at least one commercial 
program that will provide better graph- 
ics, or you can add your own graphics 
routines. More on all that later. 

SEQUENCERS 

Many kinds of information can be sent 
over MIDI, but the most important is 
note data: a steady scream of bytes spec- 
ifying which keys are being pressed and 
released. A MIDI instrument can also 
receive such data and behave as though 
the data's source is the keyboard. In 
other words, it plays the notes being 
sent to it over MIDI just as though 
someone was playing the notes on the 
keyboard. 

A sequencer can either save the data 
stream as it comes from the synthesizer 
(adding some kind of time code so chat 
it knows note lengths) or send a pre- 
viously saved stream of data to a synth 
to be played. You can buy a stand-alone 
dedicated sequencer with both hardw'are 
and software built-in, or you can use 
software to cum your micro into a se- 
quencer. 

In some ways a sequencer is like a 
tape recorder. You can play into it and 
save the result, or you can play back 
previously created music. However, there 
are some important differences. A tape 
recorder (at least a conventional analog 
cape recorder) reproduces in analog (infi- 
nitely varying) format any sounds that 
arc sent to it, A MIDI sequencer can 
only record certain limited kinds of 
data: note on, noce off, volume, ecc, Ic 
cannot score a voice, for example, be- 
cause vocal chords do not send MIDI in- 
formation. Pitches are stored as note 
numbers with a range of to 127, 

There are. however, some things you 
can do with a MIDI sequencer that you 
cannot do with a tape recorder For ex- 
ample, with a tape recorder you cannot 
change the speed of a piece without 
changing the pitch. A good professional 



sequencer can change the speed without 
changing the pitch — or change the pitch 
(transpose) u'ithout changing the speed. 
You can also change the sound on play- 
back. Maybe you like the keyboard on 
one synthesizer but the sounds on an- 
other With a sequencer you can record 
a sequence (a song or part of a song) 
using the keyboard you like, chen play it 
back through the synthesizer chac has 
the sounds you want. The only real lim- 
itation is that both synchs muse be 
MIDI -equipped. 

Sequencers for professional use have 
some incredible features. Some of them 
take months to learn how to use, and 
took years to write. The Simple Se- 
quencer ! have written does not have 
lots of fancy features, but it can provide 
a lot of entertainment, and you can add 
your own features to suit your needs. 
With this sequencer you can play music 
on your MIDI-equipped synthesizer, "re- 
cord" your playing in the memory of 
your ST. and, if you wish, save it on 
disk. You can play back anything you 
have previously entered, and change the 
tempo during playback, 

COMPATIBILITY WITH 
MIDIMAGIC 

Our modern digital sequencers are not 
the first method of storing note data for 
iacer playback. The player piano was 
enormously popular near che beginning 
of this century Composers like Scott 
Joplin or George Gershwin could cut a 
piano roll of one of their compositions 
and everyone with a player piano could 
buy a copy of the roll and listen to the 
music at home. 

Q-R-5 (Buffalo, NY) is the company 
that owns the rights to the old piano 
rolls. Many of these old, paper rolls are 
now being translated to MIDI-compati- 
ble disk files and distributed by a com- 
pany called Micro-W (Butler. NJ), along 
with a program called MIDIMagic, 
which displays the songs on a graphic 



screen similar co that of the old player 
pianos- 

I wroce the ST version of MIDIMagic, 
and since I knew I wouldn't have time to 
add fancy graphics to the Simple Se- 
quencer, I made the files that the Simple 
Sequencer produces compatible with che 
files chat MIDIMagic reads. If you own 
MIDIMagic, you can play the music you 
create with the Simple Sequencer with 
the MIDIMagic program and see what a 
piano roll created from your playing 
would look like. The piano roll offers an 
all-too-good display of keyboard tech- 
nique, and. if you hold on to a note a lit- 
tle coo long, you will be able to see it as 
well as hear it. 

(Editor's note: Your START disk con- 
tains two MIDIMagic songs, compliments 
of Micro- V^ which may be played on the 
Simple Sequencer. Although the songs 
themselves are public domain, the actual 
performances are copyrighted and. there- 
Jore, may not he reproduced or resold. 
Any songs you create with Simple Se- 
quencer are yours to do with as you like. 
You may not sell, copy, or distribute disks 
oj your songs that use the MIDIMagic 
graphic driver program, which is 
copyrighted by Micro-W. However, Micro- 
W informs us that it would be interested 
in hearing any unusual compositions you 
create, for possible marketing.) 

THE PROGRAM 

To use the Simple Sequencer, first make 
sure your synthesizer is plugged in prop- 
erly (one cable from the OUT socket of 
your synth to the IN socket of your ST. 
and a second cable from the IN socket 
of your synth to che OUT socket of your 
ST). Make sure your audio connections 
are all set and your synthesizer is on. 

Alert boxes should guide you through 
che program fairly easily. Recording will 
not start until you press a key on your 
synch, so you can waic as long as you 
wane before starting. 

The program is a fairly standard 
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GEM application and has lots of com- 
ments, so ! will not bore you with a 
line-by-line analysis. There are five main 
sections: Program Control (initialization, 
Main Loop, User i/0), MIDI Input, MIDI 
Output, Disk I/O, and Screen Displays. 

SCREEN DISPLAYS AND 
PROGRAM CONTROL 

If you have been follov-'ing Antic maga- 
zine's articles on the ST the screen dis- 
play routines will not have any surprises 
for you. Note that, either by design or by 
accident, the screen resolution (as repre- 
sented by the number returned by the 
GetrezO call early in the program) can 



be used to make automatic adjustments 
in the Y values for v_gtext calls as long 
as you are in either medium or high res- 
olution. If you are using this program 
entirely on a monochrome monitor you 
may want to change to larger letters and 
reposition the text appropriately. 

There is one point to note about the 
InitO function. I have arbitrarily set the 
maximum song file size to 37,000 bytes, 
which happens, for reasons unrelated to 
the ST, to be the maximum size for 
MIDIMagic song files. You can create 
larger files: just change the number 
#defined near the beginning of the pro- 
gram as MAXSONG, Malloc(-IL) will 



return the maximum amount of memory 
available. To maintain compatibility with 
different compilers (more on that subject 
later) I have used a temporary variable 
and a cast operation to set the pointer 
notebuffer, Alcyon C should allow you 
to eliminate the extra step; Megamax is 
stricter about data types and will only 
accept the syntax as is, since all bios and 
xbios functions are defined as returning 
a long word, 

MIDI INPUT 

The MIDI input and output routines are 
the real meat of this program. In_loop() 
sets up the beginning of the file in MID- 
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IMagic compatible format- tempo indica- 
tion at byte 56, and note and time data 
starting at byte 64, It puts a short rest 
at the beginning (it sounds better that 
way), then calls a routine that reads the 
200Hz timer to get a beginning time; all 
note timing data uses this as a reference 
point. The timer routine does not return 
to In_loop() until something comes in 
on the MIDI channel. 

In_loop() then gees all available 
MIDI data and then does a little parsing 
to make sure that the contents of the file 
will work properly with the MIDIMagic 
display routines. Then it calls the timer 
again and waits for the next MIDI data. 
The note length is derived from the 
length of time between the first note 
data's beginning and the second note 
data. $FF signals timing data, unless it 
is followed by another SFF, signaling the 
piece's end. Because of the sign-extend- 
ing which many C compilers perform on 
8-bit numbers, the highest number that 
can be used for a note length is $7F If 
the note is longer, the program will keep 
repeating SFF 7F until the variable 
notelength is below S7F. 

When you press [Esc] to signal your 
recording's end, the timer routine tells 
ln_loop() you are done by returning a 
0. Three $FFs are added to the file's end 
to signal the end, and control is passed 



back to the LoopO in the Program Con- 
trol section. 

You will notice something rather odd 
in the way that the timer function reads 
location $04BA. $04BA, where the 
200Hz click is stored, is in protected 
memory so you cannot read it from the 
68000 chip's user mode. (*pter)() has 
to be defined as a pointer to a function 
so that the XBIOS function Supexec can 
be used to go into supervisor mode to 
read the time. 

$04BA, where the 200Hz click is 
stored, is in protected memory so you 
can't read it from the 68000 chips's user 
mode. The XBIOS function Supexec al- 
lows you to go into supervisor mode, 
execute the function designated by your 
call to Supexec, and return to user 
mode. (*pter)C) is therefore defined as a 
pointer to the time-reading function to 
be passed to Supexec, 

In_timerC) is a weak link in this 
program since the timings returned are 
not as accurate as a full scale profes- 
sional sequencer would require. The so- 
lution, 1 think, would be to use one of 
the 68901 timers while shutting off as 
many of the other interrupts as possible. 

I do not recommend using the evnt 
_timer{) function in GEM: it seems to 
fail fairly often, especially when there is 
lots of I/O going on. 



MIDI OUTPUT 

The output routine reverses the input 
routine. !n this case ! used simple 
nested counting loops for timing. Note 
that I keep checking lor -1 for a timing 
byte or the end of the song. Many 
compilers will turn $FF into 
SFFFFFFFF or something equally ob- 
troxious, so -1 avoids lots of problems. 
AllnotesoffC) prevents notes from stay- 
ing on when you quit in mid-song, by 
sending a MIDI "note off" signal to every 
possible note. MIDI does provide a spe- 
cial code for all notes off, but not every 
synthesizer implements it. 

DISK I/O 

If you hnd fsel_input() or many of the 
other GEM gems confusing, I highly rec- 
ommend studying DOODLE, which 
was written by Tom Rolander and Tim 
Oren and is the property of Digital Re- 
search, Inc. I borrowed Setpath() from 
DOODLE; you can do the same since 
they explicitly grant permission to do so 
as long as proper credit is given. 

I also included two functions that 
can be found in the standard C libraries 
of most compilers: StrlenO and 
Strcat(}. I did so in consideration for 
Alcyon C users, who, in order to use 
these two short functions, would other- 
wise have to link in 20,480 bytes of 
LIBF 

1 want to point out one "undocu- 
mented feature" (some people call them 
bugs) of fsel_input(), since it caused 
me an inordinate amount of grief, fsel 
_input() sets the clipping rectangle for 
its own purposes and doesn't reset it on 
exit. If you are writing a program with- 
out windows and therefore don't expect 
to have to worry about clipping, this 
"feature" can cause a bug chat is difficult 
to track down. 

I have tried to make this program 
as compatible as possible with different 
compilers. If you are using Megamax, 
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delete or comment out the line #define 
of Sup exec, 

POSSIBLE ADDITIONS TO 
THE SIMPLE SEQUENCER 

One of the nice things about having a 
program published in START is that you, 
the reader, can enhance the program. 
The Simple Sequencer could use several 
additions, some mentioned above. For 
example, fancy graphics would be nice. 
There are several small routines I did 
not put in; an available memory indica- 
tor, for example, or some code allowing 
the user to preset the playback tempo 
instead of having to wait until the song 
starts, (Of course you can use a disk ed- 
itor to change the tempo byte before 
loading the song, but that's not exactly 
elegant.) A file mixing program could 
take several tracks recorded with the Se- 
quencer and mix them down to a single 
track for playback. 

For those of us who are real klutzes 
at the keyboard, a good step editor — 
permitting composition one note at a 
time — would be nice so that we could 
compose a song on the computer key- 
board at our leisure and have it sound 
like we had performed it on the 
synthesizer. 

If you really want to write some mu- 
sic without playing it on your sequencer 
and cannot wait to get (or write) a step 
editor, you can use any program that al- 
lows you to construct a file one byte at a 
time (like the SID.PRG that comes with 
the developer's kit). Make sure you allow 
the proper header space and put the 
tempo byte in the right place (byte 56 
with the first byte being byte 0), and 
stare your music data at byte 64, prefer- 
ably with a short rest (SFF $14 works 
well). Each note requires three bytes to 
start, S90, the note number (see/igure 
1), and a key velocity (unless you know 
what you are doing use $40), There are 
several ways to turn off a note, but for 
compatibility with MlDIMagic use $90, 



the note number, and 0. Good luck. 

MORE ABOUT MIDI 

MIDI is a complex and sometimes prob- 
lematic tool. Each instrument maker 
seems to have implemented the MIDI 
standard a little differently, so things 
that work on one synthesizer may not 
work on another. By the time you see 
this, the Simple Sequencer will have 
been tested on a variety of synths, but if 
you run into problems please let me 
know through START Magazine. 

One further note: do not try to send 
program change messages or Channel 
Pressure messages to the ST without 
changing the parsing routine in In_ 
loopO appropriately. These status bytes 
are used so rarely I decided not to in- 
clude the extra code, if you use them 
you'll have to make the necessary 
adjustments. 

I hope that the Simple Sequencer is 



as much fun for you to use as it was for 
me to write. I'm really looking forward 
to seeing what people come up with as 
enhancements. ■ 

Reference: 

• ANTIC magazine, Play it Again, 
Afari, June 1985; Midi Driver, 
March 1986. 

• Digital Research, Inc., 60 Garden 
Court, RO, Box DRI, Monterey, CA 
93942, (408) 649-3896, 

• "Ihe International MIDI Association, 
11857 Hartsook St., North Holly- 
wood, CA 91607. (818) 505-8964, 

• KEYBOARD magazine, 20085 Ste- 
vens Creek Boulevard, Cupertino, 
CA 95014-9967, (408) 446-1105, 

• Micro-W Distributing, I342B Route 
23, Butler, NJ 07405, 

(201) 838-9027. 

• Q-R-S, 1026 Niagra Street, Buffalo, 
NY 14213, (716) 885-4600. 
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BACKUP PROTECTED 
SOFTWARE FAST. 

From the team who brought you 
COPY II PLUS (Apple), COPY II PC 
(IBM) and COPY II MAC (Macintosh) 
comes a revolutionary new copy 
program for the Atari 520 and 1040 ST 
computers. 

• Copies many protected programs — 
automatically. (We update 

COPY II ST regularly to handle new 
protections; you as a registered 
owner may update at any time for 
$15plus$3s/h,) 

• Supports single and double sided 
drives. 

■ Includes both a fast sector-based 
copier and a true bit copy mode for 
protected disks. 



Requires an Atari 520 or 1040 ST 
computer with one or two drives. 

Call 503/244-5782, M-F, 8-5:30 
(West Coast time) with your 2S 41^ 
in hand. Or send a check 
for $39.95 U.S. plus $3 s/h, $8 
overseas. 

$39.95 



Central Point Software, Inc. 
9700 S.W. Capiiol Hwy. #100 
Portland, OR 97219 

CevtralPdnt 

Sojtwaw 



Backup utilities also available for the IBM, Apple II, Macintosh and Commodore 64. 
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Finally, a magazine devoted entirely to the 
Atari 520 and 1040 ST: 



' Look to SraRTfor comprehensive 
ajjielcles and programs covMng^ 
Bp^ications, programming th^Ky^ 
and tecliniques, languages, and 
Products, writtfin hu the,fnn . 
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Subscribe today and receive the most 
complete ST coverage available! 
'~ Get ST disl<-based programs with 



every issue. 
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4 issues of START, the ST Quarterly 
(with disk), plus 12 issues of Antic 
(ST Resource included). $59.95 
Mail the attached card today! 
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The Price War Is Over 

IVe Will Beat Any Price 
Anywhere 



Atari ST 
Hardware 

Atari I040ST Call 

Atari B20ST RGB Call 

Atari &20ST Mono Call 

Atari 620ST (CPU] Gall 

Atari SF354 Call 

Atari SF314 Gall 

Atari SM124 Call 

Atari SG1224 Call 

ST Station Call 

Supra Hard Diok Call 

Printers 

Panasonic Call 

Epson Call 

Citiien Call 

Modems 

ATatoi 1200 J89.00 

QWl 1200ST $129.00 

Hayes 1200 Call 

Atari XM301 J37.9& 

Supr»/MPP lOOOE $37. &0 

June 
Specials 

AVatei 1200 

PR Conn./Amodem .... $149.00 

Atsriwriter Plus $24.95 

Avstex 1200 $89.00 

SaMa SClOO $128.95 

Teknika MJ~10 $178.00 

Teknika MJ-22 Call 



Atari ST 
Software 



. $3100 
. $13.00 
. $79.00 
. Cheap 



Gal! 

$31.00 
. $24.95 

$19.95 
. Call 
.. Call 

$37.50 

$32.99 




Avatex 1200 

$89-00 

Hayes Compatible! 
Everyday Low Price! 



Borrowed Tir 

Ghat 

Final Word .. 
Haba Softwai 

Hacker $28.00 

H ft D Base Call 

H ft D Forth Gall 

H ft D Toolboi Call 

PC Intercomm $69 00 

Poreonal Diskit . .. Call 

SundoK $22.00 

VIP ProfesBional .. Call 

Silent Seryice $24.00 

Fhsht Simulator .. Call 

Micro C Shell 

Mindshadow . .. . 
Pimt MsBlet .. . 
P M Art Gallery 

Eaay Draw 

Graphic Artist . 
Music Studio 
2Key Accounting 
Home Planetarium $19.75 

Joust $19.75 

GP/M Emulator ... $32.99 
Apple ][ Emulator Call 

IBM Emulator Gall 

Megamai C Call 

Metacomco Pascal .Call 

Lattice G Gall 

GST C Call 

Andra Call 

UGSD Pascal Call 

Rejent Spell Call 

Resent Word $36.00 

Regent Word 11 $35.00 

Retenl Bass 

VIP Lite 

Micro C Shell .. 

Rubber Stamp Gall 

Megafont II Gall 

Meta 68000 Asm ...Gall 

Brattacas Call 

Degas $24.96 

Pareonal Pases! $39 00 

ST Talk $13.00 

Typesetter ST $24.00 

Zoomracka $48.99 

Modula-2 Call 

Personal Prolog . .. Gall 
Kings Quest 11 Call 



...Call 
.. Call 
...Call 



Atari S-Bit 
Hardware 

Atari 130XE $115.00 

Atari 65XE Call 

Atari lOBO Call 

Indus GT $188.00 

Atari XCll Gall 

Atari 1027 $98.00 

Accessories 

us Doubler $42.00 

Rambo XL $29.95 

R-Time Gart $43.00 

The Duplicator Call 

Indus Eipandei Call 

Bonus SS/DD 5.25 .... $8.99 
Bonus DS/DD B.26 ... $7 50 
Flip ft File All Sues Call 

Paper 1000 Sheets $11.00 

Paper 2500 Sheets Call 

Maiell 3.5 $19.00 

Sony 3.5 $21 oo 

Fuji 3.5 $19.00 

Interfaces 

P:R Connection $55.00 

Supra Microprint .. . . $29.00 

Supra 1150 $39.00 

Supra MicTonet $149.00 

Supra Microstuffer ... $57.00 

U-Print $48.00 

Apeface Call 

Atari 850 Call 

ST Printer Cable $8.99 




Atari 130XE 

$115.00 

1S8K Of Memory! 
Lowest Price Anyvjherel 



Black fttch Systems 



TO ORDER (Visa, MasterCard): Call TOLL FREE 1-800 

For lechnical information, order inquiries, or for MD orders call 301-757-1 329, 
Black Patch Systems, P.O. Box 501. Arnold. MD 21012 

Rllk Fr»» Pollcyi In-slock ilems shipped withiin 24 hours af ordsr. Nodaposil on CO O orders Freeshipping on prepaid cash orders wilhi 
BVBilBbIs MO residents add sales la«. APO. FPO. and mternalional orders and 15.00 plus 3% (or prroniy mail service. Advemsad prices 
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Software 




Acro|9t 


$19.50 


Action! 


$4200 


Basic XE 


$4200 


Basic XI 


$33.95 


Battalion Command 


(24.96 


Battle of Antietam . 


$3200 


B/Giaph 


$24.95 


Broadsides 


$24.95 


Computer Baseball . 


$24.95 


Computer QB 


$24.95 


Conflict m Nam 


$19.00 


Ciusade in Europe .. 


$24.95 


Silent Butler 


$19.99 


Cemsiona Warrior . 


$22.00 


War in Russia 


$48.00 


Dec. In the Desert . 


$24.96 


Kennedy Approach 


. $19.50 






Learning Phone 


Call 


Syncalc 130XE 


$29.95 


Megafont 11+ 


$17 00 


Rubber Stamp 


$18.00 


Paperclip 


$36.99 


Mac/65 


$4200 


Print Shop 


$26.00 


Karateka 


$18.60 


Lode Runner 


$22 00 


Atanwriter Plus 


$24.95 


Panier Grenadier 


$34.00 


Hacker 


$19.50 


Space Shuttle 


$15.75 


Mindshadow 


$15.75 


Great Am. Rd. Rce .. 


$15.75 


F-15 Strike Eagle 


$24.96 


Silent Service 


$19.60 


Gunship 


$19.50 


Synfile ISOXE 


$29.95 


Page Designer 


$1800 


Typesetter 


$21.00 


HomePak 


. $31.00 


OSS Toolkits 


. $17.99 


Pnntahop Lib. 1/2/3 


, $16.95 


Chmp. Lode Run 


$18.50 


Ultima IV 


. $39.00 




$24.96 


Home File Manager 


$7.99 


Music Painter 


. $7.99 


Star Raiders 


. $7.99 
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STEALING 

THE ST PRINTER 
DRIVER 



ST SCREEN DUMPS F O R A N Y P R I N T E R 



by Tom Hudson 



If you don't own an Epson FX 
model printer, or one of its com- 
patibles, you may find your ST 
screen dumps leave a lot to be desired. 
That masterful work of art may look like 
it was filtered through Venetian blinds — 
or worse, it may be just a jumble of non- 
sense letters. Or, how about an infinite 
form- feed? 

One of the features most often men- 
tioned in "wish lists" for the Atari ST is 
the ability to load screen printer drivers 
for various printers other than those 
built into the ST. There are several rea- 
sons one might want to print the com- 
puter screen- — aside from impressing 
friends with printer artwork. Printers 
such as the Okimate 20, for example, 
can be a perfect source of low-cost over- 
head transparencies by transferring their 
see-through, plastic-like pigment to ace- 
tate sheets. Or, if a bug appears in a 
commercial program, you may docu- 
ment the problem by dumping the 
screen to the printer and forwarding it 
to the company. 



■ his Desk Accessory lets you insfoll your own cus- 
tom/zed printer driver for either vertical or horizontal 
screen dumps at the press of the [Alternate] [Help] key 
combination. Printer drivers are included on the START 
disk and several can also be found on-line on Com- 
puServe. TOS must be in ROI\A for this program to 
operate properly Programs related to this article may 
be found in your START disk within the folder labeled 
PRNTDRVR 



Fortunately, when Atari created the 
ROM version of TOS, they created a vec- 
tor which is called to perform the 
graphic screen dump process. 

This article will describe the screen- 
dump process and how to alter the 
screen-dump vector to point to a user- 
installed printer driver routine. Since 
there are a good number of printer driv- 
ers already written for the DEGAS paint 
program, the screen-dump routine in- 



staller presented here will follow the 
DEGAS printer driver standard. (DEGAS 
printer drivers can be found in DL4 of 
the Ataril6 section of CompuServe's 
SIG*Atari, as well as on the DEGAS 
disk. We have also include some on the 
START disk with the extender .PRT.) 

If you wish to use the installer imme- 
diately, skip to the section USING THE 
INSTALLER, and have fun! ^ 
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THE BUILT-IN ROUTINES 

Each ST computer comes equipped with 
a simple screen-dump routine in TOS 
designed primarily for Epson -compatible 
printers. It may be started by pressing 
[Alternate] and [Help] simultaneously, or 
by calling the Atari BIOS crap #14 ex- 
ception processor with a parameter of 
20 decimal (Scrdmp). The GEM Desk- 
top also has a convenient drop-down 
menu selection which starts the screen- 
dump routine. 

For the lAlternate] [lielp] version of 
the screen dump, the ACIA Receiver 
Buffer Full Interrupt routine performs a 
series of tests to determine the type of 
interrupt that occurred. If it is an intel- 
ligent keyboard (IKBD) interrupt, the 
key combination pressed is checked to 
see if it is [Alternate] [Help]. If so, the 
interrupt sets a flag telling the vertical- 
blank handler to start the screen dump. 
The flag that gets everything started is 
PRTCNT, which is located at $4EE. Nor- 
mally, the value stored in PRTCNT is a 
-1 (word). When the Alt-Help keystroke 
is detected, the interrupt increments 
PRTCNT, making it zero. 

The system vertical -blank (VBLANK) 
handler is what actually starts the screen 
dump. Each time the code is executed 
(50 or 70 times per second, depending 
on the type of monitor you are using), it 
tests the PRTCNT location to see if it is 
zero. If not, the VBLANK routine pro- 
ceeds normally. However, if PRCNT con- 
tains zero, the VBLANK executes the 
SCRDMP routine to dump the screen to 
the printer. In the RAM-based TOS, this 
is a direct BSR (Branch to SubRoutine) 
instruction. In the ROM TOS, the 
SCRDMP routine is executed via an in- 
direct JSR (Jump to SubRoutine) to the 
address contained at $502. This routine 
does all the set-up work and calls a rou- 
tine called PRTBLK, which does the job 
of priming the specified portion of the 
screen (in the case of the Alt-Help or 



Scrdmp functions, the entire screen is 
dumped to the printer). 

During the screen dump, the dump 
routine watches the PRTCNT location to 
see if it changes from its zero status. If 
so, the user has pressed Alt-Help again 
indicating he or she wants to abort the 
screen dump operation, and the dumper 
will exit- After the dump is complete, 
the PRTCNT location is reset to -1 and 
system operation returns to normal. 

Interestingly, Atari has a vector to the 
screen dump routine, but none to the 
PRTBLK routine. Logically, PRTBLK 
should have had a vector pointing to it, 
since it does the actual printing. A 
pointer to a table containing all the 
printing parameters is passed to 
PRTBLK. but without a vector chat we 
can alter, this information is useless. 

The key to liarnessing the screen- 
dump routine and having the 
system execute our own screen- 
dump code is the screen-dump vector at 
$502. We install our routine in a safe 
portion of memory and repoint the 
screen-dump vector to our code. 

When a system trap instruction is 
used to start the screen dump, the trap 
handler simply calls a routine which sets 
PRTCNT to zero, simulating the action 
of the Alt-Help keystroke. It then calls 
the SCRDMP, either by a direct BSR 
(RAM TOS) or via the screen-dump vec- 
tor at $502 (ROM TOS). After the screen- 
dump code returns, the PRTCNT flag is 
reset to -1, and the system processing 
returns to normal. 

Since there are two ways of initiating 
a screen dump in the ST (Alt-Help and 
TRAP #14), the programmer must be 
sure that each calling method will prop- 
erly call the installed dumper. In the 
ROM TOS, this is no problem — one vec- 
tor change takes care of all the screen 
dump possibilities. In the RAM TOS, the 
programmer must install a pre-VBLANK 
processor and a pre-TRAP 14 handler 



which will intercept the Scrdmp call and 
execute the desired user-installed code. 
For the sake of simplicity, this article 
assumes that the ROM TOS is installed. 
Atari says the ROM TOS is installed in a 
majority of machines at this point, mak- 
ing the restriction of ROM TOS a minor 
one. 

WHAT ABOUT THE 
CONFIGURATION? 

The built-in screen-dump routine uses a 
special printer configuration word, 
PCONFIG, to determine what type of 
printer is being used. This word has bits 
chat refer to the port (serial or parallel), 
the type of printer (color or black & 
white), the mode (draft or final), and so 
on. The PCONFIG word is set up by the 
"Install printer" desk accessory provided 
with the ST, 

The location of PCONFIG has not 
been documented by Atari as of April 
1986, but in the ROM TOS ic is located 
at $E4A, I don't recommend using this 
location in any programs until Atari 
guarantees chac ic will noc change, 
DEGAS drivers are typically set up for 
one configuration anyway, so they do 
not need to look at the PCONFIG word. 

THE PRINTER DRIVERS 

When I was writing DEGAS, in June of 
1985, the support of various printers, 
including color printers, was a major 
concern. The existing screen-dump rou- 
tine in the ST was a simple, black & 
white driver for Epson printers that only 
printed images with four levels of gray- 
scale. I was noc satisfied with the out- 
put, and decided chat since no mecha- 
nism was then available to load screen- 
dump drivers into the system, I would 
create a standard driver format for 
DEGAS. This driver format, while not 
infinitely flexible, will allow screen 
dumps in color or black & white, to the 
parallel or serial port, to impact or laser 
printers, or even to plotters. 
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The drivers are not llmiced to simple 
screen dumpers, either. Since the di'iver 
is passed a set of parameters giving the 
color paletre and screen address, a num- 
ber of useful utility routines could be in- 
stalled with DEGAS thinking rhey were 
printer drivers. Two that come to mind 
are a color rotation handler for color pal- 
ette animation and a screen "clipping" 
routine which would allow the user to 
define an area of the screen to be held 
in a buffer for later use. The possibilities 
are endless. 

The DEGAS printer drivers are de- 
signed to be a block of executable, posi- 
tion-independent 68000 object code 
2000 bytes in length, which begin ex- 
ecution at the first byte in the block. 
The 2000-byte length was arbitrarily as- 
signed, and is adequate for black &r 
white and color drivers alike, with care- 
ful programming techniques. 

The drivers are called \v1th the C 
statement: 

scrdump(coTii mand , resolution , 

s creen , palette ,workare a) 
int command, resolution; 
long screen, palette,workarea; 

If the word command is a zero, the 
driver should initialize itself and the 
printer and return with a 1 in DO.W if 
the operation was successful, or a zero if 
there was an error. Typically, the ini- 
tialization function sends the printer a 
command to set the linefeed and graph- 
ics mode accordingly, to check to see if 
[he printer is connected and powered 
on. The printer driver is ALWAYS ini- 
tialized before each screen dump. 

[f command is a 1, the driver is to 
perform the screen-dump function. Dur- 
ing this process, the driver continually 
tests the keyboard to see if [Undo] has 
been pressed, and abort if it has. A suc- 
cessful screen dump returns a 1 in 
DO.W, An aborted screen dump returns 
with a 2 in DO.W If any error occurs 
during the screen dump, the driver re- 
turns with a zero in DO.W, 



The word resolution indicates the 
graphics mode that the driver is to use 
in dumping the screen to the printer. A 
zero in this value indicates the I6-color, 
320-by-200 pixel low- resolution mode, 
a 1 indicates the 4-color, 640-by-200 
pixel medium-resolution mode, and a 2 
indicates the 640-by-400 pixel mono- 
chrome mode 

The longword (four-byte) screen is a 
pointer to the base address of the screen 
data that will be used for the screen- 
dump operation. 

The longword palette is a pointer to 
an array of 16 word values that contain 
the colors used on the screen. These are 
in the standard form, in which the low 
three nibbles contain the red, green and 
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blue settings of that color. These nibble 
values range from 0-7, For example, if a 
particular color palette entry contains 
$0456, the red level is set at 4, the 
green level is 5, and the blue level is 6. 
These entries can range from $0000 
(black) to $0777 (white). 

Longword workarea is a pointer to a 
1280-byte (once again, an arbitrary 
length) portion of memory reserved for 
the driver's use. The driver can put 
whatever information it likes in this 
area, including print buffers and working 
variables. Since the driver code must be 
position -independent, this is the best 
place to put variables. 



Commented source code for two 
t^EGAS drivers (the Epson -compatible 
black & white driver and the Epson 
JX-80 color printer driver) are included 
on the START disk as examples so other 
programmers can see how one is writ- 
ten. Many printers are very similar and 
will only require the modification of 
various control codes to produce an op- 
erating driver. Others may require a bit 
more work, and I explain possible solu- 
tions below. 

Note that the Epson black & white 
driver can provide screen dumps in two 
different formats, and uses the [Alter- 
nate] key to determine which format the 
user wants. U [Alternate] is not pressed, 
the driver prints a large image of the 
screen sideways on the page. If the key 
is pressed, the screen is printed in a ver- 
tical format, slightly smaller. If you write 
a driver for another black & white 
printer, it is a good idea to to maintain 
this "standard." Color printer drivers 
rarely have enough room to ht both 
horizontal and vertical routines in 2000 
bytes, so they are written to be vertical- 
format only. 

THE EPSON BLACK & 
WHITE DRIVER 

Take a look at the EPSON.S file on the 
START disk. The first thing you notice 
in this driver is that it saves all the 
68000 processor registers in the work 
area, using AO to point to the work 
area's start. The AO register is main- 
tained throughout the driver code, and 
always points to the work area. All 
working variables (PHASE, KBSHIFT, 
etc) are set up as offsets from this ad- 
dress, PHASE is always referenced as 
PHASE(AO), This is necessary because 
the driver code must be position -inde- 
pendent and absolute addresses cannot 
be used. If the 1280-byte work area is 
insufficient, the Malice function can al- 
locate needed memory. Because of a bug 
in the current GEMDOS Malloc call, ► 
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this procedure is not recommended. So 
far, all printer drivers have been written 
using just the 1280-byte work area pro- 
vided, with room to spare. 

The driver uses a bit mask byte, 
PHASE, to mask off data to be added to 
the print data buffer. As each line of 
pixels on the computer screen is proc- 
essed, PHASE is shifted right one or 
two bits, depending on the resolution. 
The bits that are on in PHASE deter- 
mine which pins in the print head are 
used for that line of pixels. When 
PHASE is initialized to 192 decimal 
(SCO or %11000000), the mask is set 
for two print head pins. When it is set 
to 128 decimal (S80 or %10000000), it 
is set for one pin. As the mask is shifted 
to the right, it finally becomes zero. At 
that point, a print line 8 dots high is 
ready to be printed, and the PHASE 
mask IS reset. 

An important part of the printer 
driver is the code labeled printii:. This 
is a useful subroutine which takes care 
of several concerns. First, it provides a 
single subroutine which prints any num- 
ber of bytes to the Centronics parallel 
port. Second, it takes care of printer 
time-out handling just in case the user 
tries printing out a picture without a 
printer connected. If the driver makes 
270,000 unsuccessful attempts to send 
a byte to the primer, it returns an error 
code. More than a quarter of a million 
tries may sound like a lot, but this takes 
about 30 seconds, a good figure for most 
printers — especially those which shut 
down when the print head reaches a 
certain temperature. The 30-second 
time-out value also allows certain 
printers to operate at their slowed-down 
speed without causing the screen dump 
to abort. If the operation was successful, 
prinlit: returns with a zero in D0,W, If 
it failed, printii: returns a -1, 

Finally, printit; takes care of saving 
the 68000 registers D1-D2 and A0-A2, 
some of which may be altered by the 



TRAP instructions used to send data to 
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oth printer drivers included on 
the disk contain their own rou- 
tines for getting pixel values 
from the screen. While these routines 
take up precious room in the 2000-byte 
driver file, they are faster than going 
through the Line A "get pixel" routine. If 
you find yourself needing room in the 
driver, you may want to use the Line A 
calls to save space, at the expense of 
some speed. 

The horizontal-format screen dump 
prints an image 800 printer-dots wide, 
an even multiple of the 200 or 400-pixel 
high screens. This is an easy conversion 
for the driver. 

The vertical-format dump is a little 
more complicated. This dump is 960 
dots wide, which is a multiple of three 
for the low-resolution 320-pixel-wide 
mode, but only L5 for the medium and 
high -resolution modes. To take care of 
this, the driver outputs two printer dots 
for each pixel with an even X coordi- 
nate, and only one each for pixels with 
an odd X coordinate. Thus, vertical-for- 
mat screen dumps may show strange ef- 
fects on vertical lines. 

Another important routine in the 
black & white driver is the ppix: sub- 
routine, which converts the luminance 
level of a given color register value to a 
number ranging from 0-7. This gives 
standard DEGAS screen dumps 8 levels 
of gray-scale, a good range for most pic- 
tures. The number of gray-scale levels 
could be set to any value, depending on 
the programming of the driver. This 
gray-scale value is then used as an index 
into the gray-scale pixel table, which is 
built during the driver initialization at 
I200(A0). 

This driver assumes that the print 
head is configured with bit at the 
head's bottom. If you want to modify 
this driver for a printer with bit at the 



top, you'll have to flip the bits in the 
PHASE byte and reverse the directions 
of their shift operations. 

If you are using a printer such as the 
Okidaca Microline 193 which uses the 
character $03 to control graphics func- 
tions, you'll have to set up a special in- 
tercept routine in printit: which takes 
care of graphic data bytes with an $03 
value. 

THE JX-80 COLOR 
DRIVER 

One of the ST's big selling points is the 
ability to generate stunning color graph- 
ics, and as a result, many users will 
want to produce color printouts of their 
graphics masterpieces. Fitting a color 
printer driver into a 2000-byte block of 
code was a real challenge, but 1 think 
the solution used in the JX-80 color 
driver is effective. It produces fairly ac- 
curate representations of colors very 
efficiently 

The JX-80 color printer driver is on 
the START disk as JX80C.S Most of the 
basic routines used in the JX-80 driver 
will look familiar; they were lifted ver- 
batim from the DEGAS Epson driver, 
and perform the same functions. There 
are several significant exceptions. 

You will notice that there are now 
two tables built during the initiahzation 
phase. The first, BLACK Qocated at 
200(A0)), is a gray-scale table in which 
each entry is a 16-bit table. Each of 
these table entries is a 4-bit by 4-bit 
mask (16 bits total) which is overlayed 
on the printer dot pattern. The table 
ranges from black (all bits on) to white 
(all bits ofO. 

The second table, WHITE (located at 
300(A0)), is a white-scale table similar 
to BLACK. Instead of adding black as 
the brightness of a pixel diminishes, the 
WHITE cable adds white as the bright- 
ness of a pixel increases. We will see 
how this works in a moment. 



STaj/t, the ST Quarterly 



The process of printing a color pic- 
ture on most personal color 
printers is the same, regardless of 
the printer. There is usually a multicolor 
ribbon containing yellow, magenta and 
cyan portions. Most color impact 
printers also have a fourth color, black, 
for normal printing operations, such as 
program listings. Our color printer 
driver is simplified because it does not 
use the black portion of the ribbon. We 
get black by mixing the other three 
colors. 

To make the various colors needed 
for each screen-dump line, the print 
head must make three separate passes 
over each print line, one in each color. It 
is best to make the three color passes 
starting with a yellow pass, then a red 
pass, then a cyan pass, to reduce color 
contamination problems on the ribbon. 
If, for example, the cyan pass was made 
first, Followed by the yellow pass, the 
yellow ribbon would pick up cyan ink 
from the paper, making the yellow rib- 
bon more of a green color. The same ap- 
plies to the magenta ribbon, which is 
less contaminated by yellow than by 
cyan. 

Since there are only three basic colors 
present on the ribbon, some sort of al- 
gorithm is needed to mix them on the 
paper to produce colors that approximate 
those on the computer screen. This is 
accomplished by the combination of a 
large table, cvalues:, which provides 
color information, and a simple al- 
gorithm for adjusting brightness. 

cvaiues: is at the end of the listing. It 
contains 512 one-byte entries (one byte 
per color possible on the ST) made up of 
two groups of three bits each Cthe high- 
order two bits are not used). Each three- 
bit group represents a printer color to be 
used for the corresponding screen color, 
and the two colors specified in the byte 
are mixed in a 50-50 combination on 
the paper. The color specified by the 
low-order three bits is used on even 



printer dots, and the color specified by 
the next three bits is used on odd 
printer dots. For a solid color, the two 
colors are set to the same value. 

The three bits give a total of eight 
color combinations, of which white and 
black are not used, leaving six colors to 
be mixed. The total number of combina- 
tions of the various colors is 20, Twenty 
colors out of 512 would not be a very 
good proportion, so additional process- 
ing IS done using the BLACK and 
WHITE tables. 

Each pixel's color is analyzed accord- 
ing to the following steps: 
1. The total brightness of the pixel's red, 
green and blue components is calcu- 
lated, ranging from 0-21, 
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2. If the color's table entry is zero, the 
program goes to the grayit: routine, 
which calculates a level of gray-scale 
for the pixel, similar to the process 
used in the black & white driver This 
is a special case for all colors which 
have the same red, green and blue 
levels, and produces a good gray 

3. If the pixel's brightness is less than 7, 
black dots are added from the 
BLACK table (see the blakck: 
routine), 

4. If the pixel's brightness is equal to 7, 
[he color is left as is (no adjustment of 
the black & white content), 

5. If the brightness is greater than 7, 
white pixels are added from the 
WHITE table (see the whitck: 



routine). 

With the addition of varying levels of 
black and white to the original color 
mix, the driver can create a total of 20 
(basic colors) * 20 (6 black addition lev- 
els -I- normal -I- 13 white addition lev- 
els) or 400 colors, as well as eight levels 
of gray scale. While the colors may not 
match the screen image exactly, the 
color approximations are quite acceptable 
for general -purpose use, 

PRT FILES 

A special procedure is required to trans- 
form driver source code to .PRT files. In- 
cluded on the START disk is SAVER.C, 
the C source code for a program which 
will save assembled printer drivers to 
disk in the standard DEGAS ,PRT for- 
mat. To use SAVER, C, compile it to an 
object file using your C compiler Next, 
assemble the assembly source for the 
printer driver you want to save into an 
object file. Now, link these files together 
using LINK68 or a comparable 68000 
linker program to produce an executable 
,PRG program file, (See SAVER.BAT on 
your START disk for an example of using 
the EFSON.S driver) 

Remember that to successfully link 
the SAVER, C and the printer driver, the 
printer driver's executable code MUST 
start with the label s_dumper, so that 
SAVER, C knows where the driver code 
starts. 

Once you have linked SAVER, C and 
the printer driver into an executable pro- 
gram (such as SAVER, PRG), you must 
execute the SAVER,PRG program to 
create the final printer-driver file. The 
program displays the file selector box. 
Enter the name of the printer driver file 
(be sure to use an extension of ,PRT on 
the filename). The program will report 
the success or failure of the write opera- 
tion and return to the desktop. If the file 
write was successful, the printer-driver 
file is ready to use with DEGAS or the 
printer driver installer program. ► 
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THE INSTALLER 

Also on the START disk are the files iN- 
STALL.ACC, INSTALL.C and 1NSTAL.5. 
1NSTALL.ACC is a GEM Desk Accessory 
which performs the installation of a 
DEGAS printer driver. INSTALL.C is the 
C source code for the accessory, and 
INSTAL.S is the AL source code for 
the assembly language portion of the ac- 
cessory. These two source files must be 
compiled and linked with ACSTARTO 
in order to produce an executable 
desk accessory. (See 1NSTALL.BAT on 
your START disk.) 

The C source code is fairly straight 
forward, except for a couple of interest- 
ing points. 

When started by the GEM desktop 
code, the installer displays a two-button 
alert box which gives the user the choice 
of a VERTICAL or HORIZONTAL 
printout. This option is very important. 
You'll recall from the above discussion 
on printer drivers that the DEGAS driv- 
ers examine [Alternate] when initialized 
to see if it is being pressed. If it is, the 
driver shifts to a vertical print format; if 
not, the screen dump is printed side- 
ways. Unformnately, when the screen 
dump is initiated by the Alt-Help key- 
stroke, lAlternatel will ALWAYS be 
pressed as the driver is initializing, and 
therefore all Alt-Help dumps would be 
printed vertically! 

This was an undesirable result, but 
fortunately the ST BIOS has a way to get 
around the problem. There is a TRAP 
#13 call included in the OSBIND.H file 
called Getshift which allows you to get 
or sec the status of the keyboard's Con- 
trol, Alternate and Shift keys so that the 
next call to Getshift will think certain 
keys are being pressed. Some early ver- 
sions of the 05BIND.LI file contained 
an error in the way the Getshift call 
was #defined. Take a look at your 
OSBIND.H hie and be sure the definition 
reads : 



#define Getshift(a) biosCll.a) 
The earlier definitions left out the pa- 
rameter specifier (a). 

The first alert box allows the user to 
tell the installer which type of output is 
desired before loading the printer driver. 
Furthermore, if the user wants to change 
the output format at a later lime, he or 
she simply selects the "Printer Driver" 
accessory and clicks on the appropriate 
button to change the output format- The 
result of the alert is determined and the 
variable prtmode is set to either (no 
shift keys pressed) or 8 (Alternate key 
pressed). Use this variable to set the 
shift key state when the screen dump is 
called- 
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The program then calls the GEM 
file selector dialog and accepts a 
printer-driver filename. The file 
is opened and read into the address of 
the scrdmpO function. This function is 
defined in the INSTALL.S file, and is 
nothing more than 2000 bytes of re- 
served memory. If the file read into 
memory was less than 2000 bytes in 
length, an alert box appears informing 
the user, and the installer aborts without 
installing a driver. 

If the file is the correct length (no 
check is made to see if the file is over 
2000 bytes, because some drivers 



downloaded with terminal software may 
have extra bytes tacked onto the end of 
the file), the driver is installed by calling 
the installO function. This simply re- 
places the screen dump vector at $502 
with the address of our screen dump 
control routine, dumpctrl(). 

Whenever the system is asked to per- 
form a screen dump from this point on, 
the VBLANK code will call dumpctrl() 
to do the dump. dumpctrl() requests 
the system screen resolution, the phys- 
ical base address of the screen and the 
color palette, then sets the keyboard 
shift bits according to the contents of 
prtmode and initializes the printer 
driver (command — 0). 

The printer driver returns a success 
code of or L If the value is 1, the ini- 
tialization was a success, and the printer 
driver is called again with a command 
word of I, telling it to dump the screen. 
When complete, control returns to the 
system. 

USING THE INSTALLER 

First, you must have TOS in ROM in 
order to use this desk accessory. To get 
the printer driver installer up and run- 
ning on your ST, just copy the IN- 
STALL.ACC file from the START disk to 
the disk you use to boot your system. 
You should also place an appropriate 
printer driver file on this disk. If you 
can't find the right one on your START 
disk, several have been placed on Com- 
puServe. Now, boot your ST with the 
disk containing INSTALL.ACC and the 
Desk drop-down menu will have a new 
entry called "Printer Driver." 

To install a particular printer driver 
on your computer, select the "Printer 
Driver" menu item. A dialog box will 
appear giving the credits for the installer 
accessory. At this point, you will have 
two options: Horizontal or Vertical. A 
horizontal screen dump is printed side- 
ways on the printer paper in a fairly 
large image size. A vertical screen dump 
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is printed right-side-up on tlie paper, 
slightly smaller. Choose your format. You 
can always change it later. 

The computer will display the file se- 
lector dialog, showing all the printer 
driver files (.PRT) on the current disk. 
Pick your printer driver and click on 
"OK" (if you already have a driver in- 
stalled and just wanted to change the 
format from horizontal to vertical, you 
can chck on "Cancel" to avoid reloading 
the file). 

You will be notified of problems in 
installing the printer driver. Be sure you 
always have a successful load before try- 
ing to perform a screen dump. Failure to 
do so could lock up your computer. 

Once a printer driver is installed, you 
can print the screen to whatever printer 
the driver is compatible with, either in 



color or black & white. Just press Alt- 
Help like you normally would or use the 
GEM desktop's "Print screen" option. 

To abort a screen dump using the 
DEGAS drivers, press [Undo]. This is 
the only difference between the installa- 
ble DEGAS drivers and the built-in 
driver, which aborts when Alt-Help is 
pressed a second time. 

It is not necessary to set the printer 
configuration by using the "install 
Printer" desk accessory when using the 
DEGAS printer drivers. The DEGAS 
drivers are specifically written for one 
configuration and do not use the infor- 
mation in the "Install Printer" dialog. 

FINAL WORDS 

As more and more printer drivers be- 



come available for the ST series, the ma- 
chine will become more useful to a 
larger group of people. I hope this infor- 
mation and the printer driver installer 
will inspire more programmers to write 
DEGAS-format printer drivers — They're 
not just for DEGAS any more! ■ 
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• A Hitchhiker's Guide to the BIOS, 
Atari Corp, 
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REGENT BASE 

A FULL FUNCTION 
RELATIONAL DATABASE 
Regent Base's procedural language 
make it a natural for handling any of your 
small business needs. Modules are 
available for Invoicing, Accounts 
Receivable. Checkbook Balancing, 
General Ledger, etc. 
Regent Base is a relational database 
written specifically for the Atari ST Don't 
settle for simple clones of /SM products. 
Regent Base is easy to use and state-of- 
the-art! 



REGENT SOFTWARE 

7131 Owensmouth, Suite 45A 
Canoga Park, CA 91303 
(818)883-0951 
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Technical support, personal service, com- 
petitive prices. 
Disclone full service quality tested diskette 
duplication, packaging, documentation pro- 
duction and processing ensures precise 
duplication, thorough quality control and 
expedient response to your requirements. 
NOclone slate of the art hardware based 
copy protection is true piracy protection for 
authorized allotments only. Each application 
is uniquely encrypted. Install routines are 
coded for nontransferrable hard disk allot- 
ments. 

Disclone offers a choice of diskettes. Com- 
mittment dates are guaranteed. Fast turnover 

■ up to 1000 in 24 hours, any format, 

■ up to 10,000 in one week, any format. 
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Advanced Technology for LESS! 



The SD-2000 Disk Drive System 
is this year's most exciting new 
peripheral for the ATARI ST", and 
it's the only one of its kind for any 
computer anywhere in the world. 

Fast, full featured and compact, 
the SD-2000 is smaller and more space 
efficient than one single stand-alone 
Atari drive, Connplete with A + B drive 
identification, slip-proof rubber feet, 
pop-up elevating kickstand, tliis 
versatile drive system measures only 
4'/?" W X SVs" D X 21/4" H and includes 
two 3,5" 1 MB, double sided, 



You be the judge. 




double density drives, and is finished in 
a sieei< contoured, coior-coordinated 
gray metai case. 

And there's more! Through the 
advanced engineering of the Shanner 
System, there's nov^ no longer the need 
for that extra pov^er supply and cum- 
bersonne cable. Both Shanner drives 
operate off a single power supply 
through its unique "LOW POWER 
DESIGN" capability. 

The SD-2000 comes complete with 
power supply, I/O Cable, registration 
card and manufacturer's warranty. 

The Shanner 

SD-2000 

Disk Drive 



95* 



\-4>/r width ^ 
SD 2000 



$429 

SHANNER INTERNATIONAL COEIP. 

The SD-2000 is a creation of, and marketed 
worldwide by Shanner Internalional Corp, 

'"^'"" ""■^ "in ST are IraOemaiks ol Alan Corp. 
"s Suggesled Retail Prices, 



See ttie local authorized dealer nearest you or use this SPEEDY order form. 

_ SD-2000 Disk Drjve(st 



Please send me- 
al $429.95 each, plus $1 5 00 for postage & handling, 
(CA residents add $27.95 lor sales lax) 
Please indjcale method of payment; 

n Check D Money Order D ViSA D Maslercharge 
Orders may be sent to: 

Shanner Internalional Corp. 
453 Ravendale Drive 
IVlountain View. CA 94043 



City . 



Pnces subiecl lo ciiange without notice 



Dealer Inquiries Accepted 



For direct orders, call our HOTLINE 1 -800-423-8673. In CA 1 -800-626-9273. 



PROCEDURES 



Moving 
l6-color 
Objects 



AL Routines for C.O.LR. Object Editor 



BY JOE CHIAZZESE 



Using AL routines ■within a C structure, this article 
demonstrates how to move 16-color objects (created with 
the C.O.L.R. Object Editor) swiftly around the screen. 
All related program files may be found within the 
COLRMOVR folder on your START disk. 



■ Jl Mhile playing the popular 8-bit Atari game Karateka, a visually sophisticated 
If If Karate cartoon, 1 was inspired to duplicate the main character's actions on the 

■ W Atari ST. Two day's work convinced me that I'm a terrible artist, but did at least 
produce a set of assembler routines to manipulate images created with Antic's CO-L.R. 
Object Editor 

These routines should serve as a great learning tool for many people. To show how to 
use them from C, I've written a demonstration program which allows any size image 
(within reason) to follow the mouse around on the screen. 

The complete program has three parts: the assembler routines to handle the images, 
the C routines to make the program logic easier to understand and the image itself. 
Creating the final program requires four steps: I) drawing the image and converting it to 
source code, 2) assembling the image- handling routines, 3) compiling the main C 
program, and 4) linking all the files together ► 
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PROCEDURES 



Objects . . . 



CREATING THE IMAGE 

Tliough you may tollow chis procedure using your own display 
image, 1 originally tried it with the karate character and sam- 
ple files on the START disk include chis data. After drawing 
the karate character's image, C.O.LR. Object Editor's Create 
Source option was used to save the image as assembler source 
code statements with a label. This was not quite enough: in 
order to link the image's label to the C code, the label must be 
global. Do this by adding the -globl label directive to the im- 
age code data using any standard programming text edicon 
The .globl directive can be put anywhere in the source 
code created by C.O.L.R. Object Editor, i suggest the top so it 
can be found easily. Since Alcyon C adds the underscore char^^ 
acter in front of all its external variables and routines, the im- 
age's label must begin with an underscore so the image label 
matches that defined in the C program, as must the names of 
the routines in the assembler source code. For example, the 
routine 1 call save_screen in C must be _save_screen in as- 
sembler to match it. 



1 wanted 

generic assembler routines 

which would work with any size 

object. 



CIASSEMBLER INTERFACE 

1 wanted generic assembler routines which would work with 
any size object, and not just the specific karate character ex- 
ample. The routines designed, therefore, had to accept param- 
eters from an outside source. When the subroutine is called, 
the return address is pushed onto the stack. Since C places all 
parameters on the stack in reverse order, the parameters are 
accessed at the current stack position plus four bytes (the re- 
turn address is 32 bits long requiring 4 bytes to hold it). For 
example: put(dev ice, char); pushes char on the stack first fol- 
lowed by device with the stack growing downward. 

THE ASSEMBLER ROUTINES 

The assembler portion of the demonstration consists of five 
routines, each with a very specific function as discussed 
below. 

_save_screen copies a block of specified width and height 
from the screen to a buffer. The buffer must be allocated by 



the C program and it is the programmer's responsibility to in- 
sure there is enough room. The buffer can either be an array 
or a block of memory allocated from the operating system, in 
which case a pointer is needed to tell the routine the buffer's 
location. All the routines expect the object's width to be spec- 
ified in words, not pixels. The height is in lines. (Both of these 
numbers are displayed when creating source with the C.O.L.R. 
Object Editor.) All buffers and screen positions are passed as 
absolute addresses. 

The C portion of the program is responsible for converting 
X and y coordinates into absolute screen addresses. The ad- 
dress is calculated and then passed to the assembler routines 
which, in themselves, have no provision for such conversions. 

_restore_screen reverses the effect of_save_screen by 
replacing the previously saved block of screen memory. 

_shift_image is a little more complex. Given the address 
and size of the original object, it shifts the image to the right 
by the specified offset and stores the result where told. The re- 
sult is an image one word wider than the original. This new 
image is used by all the other routines; the original only serves 
to create another image which can be shifted to the right by 
up to 15 pixels. Even if the offset is zero, the object should be 
put through this routine because it creates an image which is 
one word wider, and the assembler routines actually expect to 
be working on an object which is a vrord wider than the width 
specified. If the given width is two, for example, the routines 
manipulate an object of width three. 

The shifted images are necessary because screen memory is 
arranged in word-sized, 16-bit chunks. Each shifted image 
corresponds to an image chat begins on different bits, or pix- 
els, of a word of screen memory. 

To have the background show through the empty portions 
of the object, you need a mask for the object. Rather than cal- 
culate the mask for every object, the _inake_mask routine 
automatically creates one. All it needs is the size and address 
of the object and a place to put the mask. Each mask uses half 
the memory space of its image. 

Finally, _draw_image_ takes the image, the mask, and the 
saved background, mixes them all together, and puts the final 
picture on the screen with background showing through. First, 
the background is loaded, ANDed with the mask, then ORed 
with the image. This causes any blank sections of the image to 
appear transparent. 

I chose to mix in the background from the saved buffer and 
not the screen. Although this means the background has to be 
saved first for the routine to function properly, there's no need 
to restore and save the screen again if the picture is drawn in 
the same screen block. So, if the picture is drawn at point A', ic 
can be moved up to 15 pixels to the right and still be drawn 
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on the same block using only an image shifted b\' a dillerfnt 
oHsei. 

THE C ROUTINES 

The main routine is simple: it opens the workstation, ini- 
tializes and if successful, calls follow_mouse() (which is re- 
ally the main routine). It then cleans up and closes the 
workstation . 

open_workstation() and close_workstation() are the 
standard GEM routines used in most programs. I make it a 
habit to put them in every program in case 1 need them later. 
finish_up frees the memory allocated by initialize(). 

initializeO does several things: it checks the resolution 
and returns you to the Desktop if the resolution is anything 
but low. It saves the screen's base address in scrbase, then al- 
locates memory for all the images and masks. You will also 
find yourself back at the Desktop if sufficient memory is not 
available. 

The default palette is saved so that it can be restored at 
program's end. A new palette is set and the background is 
filled with a wall pattern. The image is then shifted through all 
16 different positions within a word and each one is stored for 
later use. At the same time a mask is generated for each of the 
images. Finally, to initialize the main loop, a screen block is 
saved once and oidpos is set to point to it. 

On entry of follow_mouse(), we encounter a while loop 
which continues until a key is pressed. To avoid repeatedly re- 
drawing the image at the same place, a DO loop has been 
placed within the while loop which will exit if the mouse is 
moved or a key is pressed. The x and )' coordinates of tlie 
mouse are used to calculate the absolute screen position. We 
now wait for the next vertical blank to occur to minimize 
flicker. {A certain amount of flicker will still be noticeable 
when the image is at the top of the screen. To eliminate this 
calls for a complicated technique of multiple-screen image 
switching which is beyond the scope of this article.) If the ob- 
ject is in the same screen block, it is simply redrawn; other- 
wise we restore the background where the old image was, sa\'c 
the new block, point the old position to the latest one and 
then draw the image. 

CUSTOMIZING 

If you want to change the program so that your own picture 
gets dragged around the screen, go to the top of the C file and 
change the #define statements to reflect the size etc, of your 
own picture. OBJW is the width in words, OBJH is the height 
in lines and COEOBJECT is the label of your picture. Link it 
in and that's it, (Don't forget to make your object label a 
global!) ■ 
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ICONOGRAPHICS 



The 
Digital 
Magnet 

Plotting Magnetic Field Lines 



BY DAVID SMALL 

This spectacularly colorful graphics program simulates 
magnetic field line generation. If you are more interested 
in detail than color, you can also run it on a monochrome 
system; it works in any resolution. Related files may he 
found within the MAGNETS folder on your START disk. 



f' guess magnets have always fascinated me. As a kid, I loved to play with iron filings 
and magnets, electromagnets, and whatnot. 
One day in freshman physics we were discussing formulas governing magnets, I woke 
from my usual haze just enough to note the formulas and think, "This would make a neat 
program." At our local computer center, there were two unused Tektronix 4013 graphics 
terminals hooked up to a Cyber mainframe, so I spent some time on them and wrote the 
original Magplot, a magnetic field lines plotter 

The program wasn't a wa.ste of time. After all, it helped me pass my freshman physics 
class. It also earned a reputation for pulling computer time out of the mainframe; when I 
ran the program, 1 could hear the chatter of teletypes in the next room slow down, 
sometimes stop, a result of all the floating point arithmetic going on. 
Welt, enough history. Let's look at the program. 

THEORY 

The formula for attraction between two charged particles is; 

(CHARGEl * CHARGE2) / (DISTANCE SQUARED) ► 
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Ploffing magnetic field lines in GRID mode, or. . 



.in POINT-POINT mode. 
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Or, [he attraction'repulsJon bet\s'een two objects is dependent 
on their distance squared. You'll find this same relationship in 
other popular formulas, such as for gravity. 

With multiple particles, you must calculate the force ex- 
erted at any point by summing up the charges exerted on each 
point by each particle. The easiest way to do this is to calcu- 
late each force as a vector, then add up the vectors. You end 
up with a vector which, at a given point, represents the sum 
total of the at tract ion /repulsion being exerted on it at that 
point. 

This is similar to figuring out the direction a satellite will 
go by summing up the relevant gravitional pulls from all the 
bodies (the sun, planets). 

If you then draw a small line in the direction the vector 
points, recalculate the attract ion/ repulsion, and so on, you will 
obtain a picture of the field lines around magnets. If you've 
ever done the experiment wich iron filings and a magnet, the 
plots done by this program will look remarkably familiar. 

Two like forces will repel each other; you'll see the field 
lines reflect this, as the " + " and " + " points repel one an- 
other. Opposite forces attract, again, you'll see the field lines 
traveling from " + " to " - ". 

There's also a physics theorem that field lines plotted this 
way will never cross one another. This is the case in the 
program. 

PROGRAM 

The program was originally written in Cyber BASIC, and over 
the years has ended up on an amazing variety of graphics-ori- 
ented computers. The ST and C language are the latest target, 
and one of the faster implementations; the 68000 and C seem 
to be pretty adept at floating point arithmetic, which this pro- 
gram spends a vast amount of time doing. You will see a cer- 
tain amount of BASIC within the code in this incarnation of 
the program, including the entirely global variables. Please feel 
free to optimize it. Quite honestly, the original program took 
me so long to get working properly under BASIC, I have a 
mental block about playing with it too much. 

The program has three main sections. The first involves ini- 
tialization and setup of controlling variables. Since the ST's 
processor is not infinitely fast, there are some practical limits 
to make the plot occur reasonably quickly, I've set these up as 
easily tweaked variables in a procedure called inilglobals; feel 
free to play around with them. Here's the rundown: 

A) linelength: This is how far a line is drawn in a given 
vector's direction. Too long, and the smooth curves of the field 
lines will become jagged; too short, and the CPU will spend 
too much time calculating between points. 

B) clipit: This variable, if found to be True, "clips" field lines 



to the size of the screen; m other words, if you're drawing a 
field line and it goes offscreen, the line is terminated. The 
problem here is that offscreen lines are pure CPU calculation 
and the wait on them can get pretty tedious; on the other 
hand, most plots look far more complete if you include the off- 
screen line. If you select no clipping, then the line is termi- 
nated only if it goes wildly out-of-bounds and has little chance 
of returning on to the screen area. 

C) degreeinc: The starting point for each line is on a circle 
around positively charged points. The line then travels to a 
negative point, by whatever route, or gets terminated off- 
screen, degreeinc determines the degree increment between 
starting lines. The lesser this variable, the more lines are plot- 
ted off each positive point; on the other hand, it takes longer 
to generate a given plot. If you make this variable very low, 
you'll have quite a dense and good looking plot, but it will 
take awhile to generate. 

D) k2: This is a miscellaneous force constant that deter- 
mines how much strength a magnetic field has. If you've ever 
wanted to play god and turn off magnetism, here's your 
chance. The value is more or less kludged to make good plots. 

E) radius: This value determines the "black hole" radius 
around a negative point and also determines the starting ra- 
dius of each positive point. 

The second section of the program lets you input the 
charge points using the mouse. This is done primarily within 
inputpointsO- Admittedly, it is a bit kludgy, but it does not 
require resource files or calls to the AES. This shortens and 
simplifies the program, particularly if you don't have the Re- 
source Construction Set. 

When the mouse button is pressed during point input, the 
point's X and Y locations are recorded, and a "menu" for 
positive/negative is displayed. Click on either POS or NEG to 
select that point's charge. I store the X,Y, and charge of the 
point in three arrays, xcoord, ycoord, and (creative name) 
charge. 

The "menu" is then erased. 

When you press |Shift| or [Alternate], you exit the while 
loop that inputs the points, and proceed to the program's third 
main section which deals with plotting the picture. 

PIOTITQ 

There are two ways of creating the picture. One gives a fairly 
accurate picture of the field lines by plotting continuous lines, 
the other a good-looking plot by plotting one line on a grid 
overlaying the picture area. I include both; you select which 
one you'd like with the gridstyle option. If you want the grid 
approach, exit the point-input process with lAlternate] ; if you'd 
like the point-point approach, use [Shift], 
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In grid mode, we start at all X's and Y's forming a grid on 
the surface, calculate the line direction at that particular point, 
draw the line, and move to the next point. The line's color is 
drawn based on the amount of force present at that particular 
point (the vector summation), which makes for a spectacular 
display in low or medium-resolution. 

In point-point mode, we run several nested loops. In order, 
they are: I) Cycle through all positive points; 2) Start a line at 
N points around each positive point; 3) Sum charges at each 
point, draw the line. 

The charge summer is set up as a separate call to make 
grid plotting easier. The CPU spends most of its time here, as 
the variables are double floating point, required because of the 
fractions involved. You'll find the distance between points 
being calculated as sqrt ( (xl-x2) squared + (yl-y2) 
squared ), You'll also find the basic force equation here. 

The charge summer inputs the point as xl, yl (old BASIC 
variable names) and outputs the next point on the line, scaled 
to linelength, in the same variables. 

VDI's v_pline (polyline draw) then draws the line and 
proceeeds to the next point. 

CONSIDERATIONS 

There are some interesting practical considerations that I ran 

into when designing this program. 

t) How should the lines start in order to create an even plot? 
This was solved by using polar coordinates around each 
positive point. (You can't begin a line at a negative point be- 
cause it travels towards the nearest negative point — -itself.) 

i) How do you terminate the line? This was not trivial. It is 
easy if the line goes offscreen, but, when the line nears a 
negative point, there is a "black hole effect"; the distance is 
so short that the negative point becomes the only relevant 
force. The line is drawn one linelength past the negative 
point, which causes it to overshoot the negative point; it 
then turns around, overshoots, and so forth, creating a 
ping-pong effect. 

The solution here is to terminate a line whenever it be- 
comes radius close to any negative point. This stops the 
ping-pong effect. Regrettably, it involves calculating the dis- 
tance Co every negative point on each line draw, which in- 
volves extra CPU time; perhaps a simpler solution would be 
a subtraction against each negative point's coordinates, 

What if the line goes offscreen? There is special code to 
handle this case, if you decide to let the line wander off- 
screen and return. The variable newline "initializes" the 
Une for subsequent v_plines so you don't get a strange 
skipping effect. 
There are some miscellaneous routines to make the plot 



work on any style monitor The high-res monitor, of course, 
gives the cleanest picture, but there are only two colors, black 
and white. The two color modes allow some interesting pos- 
sibilities for color and animation. I cycle through the color reg- 
ister numbers (either 0-3 or 0-15) while drawing the force 
lines, and the result is a pleasing multi-color force line; if the 
color registers are then rotated "underneath" the plot, so to 
speak, the force tines become animated, travelling from 
positive to negative points. You'll see the rotation code in the 
line drawing routine. 

As the code notes, the GEM color number seldom corres- 
ponds to the extended BIOS call hardware color number. This 
caused me some trouble, and 1 had to include a fair amount of 
code just to deal with this problem. 

You might find the "POS/NEG" code to be useful in writing 
resolution independent codes. I calculate all the X and Y con- 
stants on the basis of character width and screen size returned 
from the VDI "open workstation" call. ■ 



HOW TO RUN 

MAGPLOT 

/. Double click on the program's file icon, 
MAG21.PRG. Once the program is loaded, the top screen 
will read: Exit: (SHIFT = pt-pt; ALT = grid). At this 
point, pressing [Shift], [Alternate], or [Control] will exit 
you to the Desktop. 

2. Click the mouse anywhere on the screen where you 
would like a point, then click on either POS or NEG to 
select that point's charge. Continue inputting points like 
this until you have as many as you like. A quick demo is 
two points — one positive and one negative — a distance 
from each other on the screen. 

J. Having chosen your points, press [Alternate] to 
plot in GRID mode, [Shift] to plot in point-point mode. 
Try both to see the difference. During the actual plot- 
ting—or when finished, you may restart by pressing 
[Shift], or exit the program by pressing [Control], 

MAG21 works in all resolutions but is flashiest in low- 
res. On color monitors, the program will color-cycle at 
the end of point-point mode. 
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TRACKING 

THE ELUSIVE 

GDOS 

THOSE MISSING METAFILES 



by Tim O 



aA valuable examina- 
fion of GDOS and 
metafiles by the pro- 
grammer who helped 
write the GEM system. 
Discover why Atari's 
"color Mac" is currently 
incapable of using multi- 
ple fonts. Never heard of 
GDOS? Read on. 



An important chunk of GEM 
was left out of the Atari ST 
when T05 was placed in ROM, 
It's called GDOS, and its absence is the 
reason your ST does not have multiple, 
Macintosh-like fonts. But GDOS (Graph- 
ics Device Operating System) can be 
added to your system, and with its 
associated "metafiles," you may output 
identical images to' such diverse periph- 
erals as the screen, printers, cameras, 
and more. GDOS was first used for the 
ST in Easy Draw, from Migraph. An of- 
ficial version should be available from 
Atari soon. 

In theory, a fully implemented GEM 
system utilizing metafiles permits, 
among other things, graphic output to 
various peripherals at the highest resolu- 
tion of which the peripheral is capable. 
For example, a metafile, creating a pic- 



ture image on a medium -resolution 
screen, will take advantage of the high- 
est matrix density of a graphics printer. 
The same picture may also be output to 
a plotter or camera. Again, much of this 
is "in theory." Digital Research has yet 
to complete full implementation of all 
capabilities of GDOS — and its related 
OUTPUT PRG application. But some of 
the abilities are currently available for 
the ST Let's take a closer look. 

TOS STRUCTURE 

To understand the role of GDOS on the 
Atari ST, let's look at the system soft- 
ware (TOS) which already exists in 
ROM. (See figure 1.) There are two sec- 
tions: GEMDOS, which handles disk 
and keyboard input and output, and 
GEM, which manages the mouse and 
on-screen graphics and windowing. 

GEMDOS has three parts. The BIOS*- 
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DISK KYBRD SCREEN 



(Basic Input/Output System) handles 
hardware level interaction, such as get- 
ting a single character from the key- 
board or reading a sector from a floppy 
disk. The XBIOS (Extended BIOS) con- 
tains hardware level calls peculiar to the 
ST, such as setting palette registers and 
configuring the sound chip. The BDOS 
(Basic Disk Operating System) handles 
disk interactions at the logical level, such 
as creating, writing, and reading files. 

The GEM portion of TOS, with 
which we will be the most concerned, is 
also composed of three major parts. The 



first is the VDl(Virtual Device Interface), 
which handles graphic I/O functions 
such as drawing lines and performing 
bit-blit operations. (Bit-blit stands for Bit 
Block Transfer, a technique of moving — 
or copying — a block of pixels from one 
place to another.) The AES (Application 
Environment Services) performs logical 
level screen actions, such as window 
handling, drawing and processing di- 
alogs, and animating the menus. Finally, 
the GEM Desktop application provides 
the user's window and icon interface to 
the file system. 



The terms "virtual" and "device" in 
the definition of VDI mean that it, in ef- 
fect, creates a new graphics machine 
which you can program instead of writ- 
ing directly to the graphics screen your- 
self. The "VDI machine" is able to create 
lines and circles, write graphics text, blit 
portions of the screen, and so on. An 
application which uses only VDI calls to 
create graphics should work on any ma- 
chine which uses GEM, or on any device 
attached to the ST for which a VDI 
driver has been written. By accepting 
this restriction, a developer gains por- 
tability for his or her program, and lever- 
age for his or her efforts. 

ST'S ABSENT GDOS 

On most GEM machines, the VDI con- 
sists of three parts: fonts, drivers, and 
GDOS. Fonts define various styles and 
sizes of characters which can be written 
on an output device, A driver is the 
piece of code which implements the VDI 
machine for a particular output device. 
The GDOS is the device-independent 
part of the VDI, which (among other 
things) sends an application's VDI calls 
to the correct output device. 

However, there is currently a problem 
in using this method with the Atari ST. 
The VDI as implemented in the ST's 
ROMs includes only a single device 
driver and set of fonts. The driver in- 
cludes code for all three resolutions of 
the ST's graphic screen, and there are 
two font sizes defined for each resolu- 
tion. The parts missing from the ROMs 
are the GDOS and VDI drivers for other 
devices, such as printers. 

Because the GDOS is missing, a 
GEM program on the ST loses the de- 
vice independent capabilities of the VDI. 
Specifically, it is unable to load new 
drivers or fonts, or to use the NDC 
(Normalized Device Coordinate) scaling 
system to draw pictures. The lack of a 
GDOS leads to several problems for ST 
developers and users, (We can point the 
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finger two ways here: Digital Research 
did not deliver the GDOS code to Atari 
soon enough, and, in any case. Atari did 
not have enough room in their TOS 
ROM to include it.) 

Since VDl graphics cannot be written 
directly to a printer, programs are forced 
to do bit-by-bit printer dumps of screen 
images, using specially written driver 
code. Thus, a paint program like DEGAS 
has to include a different driver for each 
printer which might, be hooked to the 
ST. Worse, no other program can make 
use of these drivers. Because there is no 
standardized GDOS to define the driver 
interface, each developer ends up wast- 
ing a good deal of time. 

A second problem is the loss of abil- 
ity to load fonts. Although there is a way 
to force the ST screen driver to accept a 
different font (see sidebar), the standard 
GDOS load and unload font commands 
are not available. Also, since Digital Re- 
search purchased its original fonts from 
an outside source, the GEM developer's 
software has never included a Font Edi- 
tor. These two problems have so far pre- 
vented the creation of a wide variety of 
fonts on the ST, such as has occured on 
the Macintosh. 

Fortunately, a GDOS has been 
written for the ST by Digital Re- 
search, and should soon become 
available to developers. As of April 1986, 
Atari is testing a final version of the 
GDOS software- Already one product 
which incorporates the GDOS, Easy- 
Draw from MiGraph, has been released. 
(Developers should be warned, however, 
that the GDOS shipped by MiGraph is a 
preliminary version which may contain 
bugs in functions not actually used by 
Easy-Draw), 

The GDOS for the ST is shipped as 
a loadable program, GDOS.PRG. which 
is placed in the AUTO folder to be run 
at boot time. The GDOS is a terminate- 
and-stay-resident program which means 



that once it is loaded it returns control 
(but not consumed memory) to the OS. 
When it is run, it places a pointer to it- 
self m the 68000's TRAP 2 vector, sav- 
ing the previous value, which is the 
vector [0 the VDI and AES. When an 
application is running, all TRAP 2 calls 
are screened by the GDOS, which proc- 
esses functions that it recognizes and 
passes others on to the AES and ROM- 
resident VDl code. 

ASSIGN.SYS 

When it is first run, GDOS also reads 
a file named ASSIGN.SYS (see figure 2). 
This file tells the GDOS which drivers 
and fonts should be loaded into RAM for 
all programs to use. [This loading sub- 
tracts from the RAM available for your 
applications to run.) The exact format of 
ASSIGN.SYS IS described in the VDI 
manual. For our purposes it suffices that 
it associates numeric device IDs with 
their driver filenames and font files. 

It is useful to know a few of the stan- 
dard device IDs. The value one (1) is al- 
ways associated with the screen. Device 
ID 21 is the printer, if one is installed. 
Device ID 31 is for a metafile driver, 
which will be described later. A device 
ID must used with the open workstation 



v_opnwk VD! call, so that the GDOS 
can tell which physical device you want 
to address. 

Notice, by the way, that you do not 
need to open the screen as a worksta- 
tion if you are using the AES. The AES 
automatically initializes the screen work- 
station at boot time, and returns its han- 
dle as a result of the graf_handle call. 
Your application then uses this handle as 
an input to the v_opnvwk VDI call, 
which opens a VIRTUAL workstation for 
your use. 

This is a good point to define the dif- 
ference between a physical workstation 
and a virtual workstation. The physical 
VDI workstation is associated directly 
with the device itself, so only one phys- 
ical station can be open for any one de- 
vice at a time. A virtual workstation is a 
software construct which is associated 
with the physical workstation, but saves 
an independent set of VDI parameters 
such as line thickness, writing mode, 
text style, and so on. Using the virtual 
workstation method, your application, 
the desk accessories, and the AES itself 
can all write to the display screen via its 
physical workstation, but without de- 
stroying each other's VDI parameter 
settings. ►■ 



SAMPLE ASSIGN.SYS FILE 


Olp SCREEN.SYS 


; ROM- resident screen driver 


IBMLSSIO.FNT 




IBMLSSM.FNT 




BMLSaa.FNT 




BMLSS36.FNT 




21 FX80.SYS 


; Epson printer driver 


EPSHSSIO.FNJ 




EPSHS34INT 




EPSHSS20.FNT 




EPSHSS36.FNT 




31 META.SYS 


; Metofiie driver 
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TRACKING . . . 

, eturning to the ASSIGN. SYS 
file, the driver filenames all 
Lend with a SYS extention. For 
example, FX80.SYS is a driver for an 
Epson FX-80 printer, and META.SYS 
is the metafile driver. The special name 
SCREEN. SYS refers to the screen drivers 
which are already present in the ST's 
ROMs. 

Font files always have names ending 
in FNT. One or more font files will be 
associated with each driver. Fonts come 
in a variety of styles and sizes, and the 
file name usually describes the device, 
style, and size of the characters it 
contains. For instance, a file named 
EPSHSSIO.FNT contains a 10-poinc f}'pe 
face for use with the Epson printer's 
high resolution mode. 

Note that an application is not re- 
stricted to only those fonts named in the 
ASSIGN.SYS file. When the GDOS is 
present, the application can also use the 
vst_load_fonts VDI call to bring addi- 
tional font files into RAM from the disk. 
It can then use set_font to switch to the 
alternate typeface. However, fonts loaded 
in this manner are only available to the 
application which called them; they will 
disappear when the program terminates. 

Using the GDOS and alternate driv- 
ers, your program can write to devices 
such as the printer using the same 
graphics commands that work on the 
screen: lines, circles, text, and so on. 
However, bil-blit operations only work 
with the screen and internal RAM of the 
ST. To create a bit image on the printer, 
you must first store the image in a file 
and then use the VDI's Output Bit Image 
File v_bit_iniage command to write the 
file to the output device. 

In many cases, the device driver 
builds a bit-by-bit image of the printed 
page in memory, and you will need to 
use the update workstation call, v_ 
updwk, to force output to actually 
begin, and then the clear workstation 
function, v_clrwk, to advance to a 



new page. The output window function, 
v_output_window, is also available 
if you need to force only a part of the 
picture to the printer 

METAFILES 

It is the metafile driver, however, which 
has the most interesting implications for 
ST developers. To understand the defini- 
tion of a metafile, recall the notion that 
the VDI creates a virtual graphics en- 
gine, which is driven by commands sent 
by the application via the VDI bindings. 
In these terms, a metafile is simply a re- 
cording of the commands which created 
a given picture. By "replaying" these 
commands with a suitable program, you 
can generate a copy of the picture on 
any VDI output device. 

Such a program is provided with the 
GDOS distributed by MiGraph and Digi- 
tal Research. It is a full-fledged GEM 
application called OUTPUT PRG, which 
you may invoke from the Desktop, If 
your application simply needs a method 
to create graphics which may be re- 
played for any device, this stock pro- 
gram should suffice. Unfortunately, due 
to bugs in the shell_write call, there is 
currently no reliable way to invoke 
OUTPUTPRG from an application, 

A GEM application generates a meta- 
file by opening a physical workstation 
with the metafile device ID 3L By de- 
fault, the metafile will be named GEM- 
FILE.GEM, but you can change this by 
executing a vm_filename command im- 
mediately after opening the metafile 
workstation. From this point on, you 
can use most Control. Output and At- 
tribute VDI functions with the worksta- 
tion, (see^gure 3). Note that, like a 
printer, a metafile can only accept bit 
image data if it is provided in a file. 

The metafile commands are accumu- 
lated in a buffer and written to the disk 
when the buffer is filled. Closing the 
metafile workstation forces the contents 
of the buffer to the disk and closes the 



IMPLICATIONS 

Useful though the "playback" ability of 
the metafile may be, it has greater im- 
plications for those writing applications 
which do on-screen graphics editing. 
Consider a standard "Paint" type ap- 
plication, such as DEGAS or Neo- 
chrome. When such a program 
generates a square or circle on the 
screen, it becomes a mere collection of 
bits. There is no way, short of erasing 
and redrawing, to change the size or 
shape of the object once it has been 
drawn. 

Let's extend the notion of metafile to 
solve this problem. If the metafile is a 
copy of the instructions which drive the 
VDI engine to create a particular picture, 
then you can equally well store this se- 
quence within the program's memory. 
This allows you to edit the commands, 
rather than the bits generated. This 
technique is the origin of "Draw" type 
graphics programs, which allow the fig- 
ures on the screen to be manipulated as 
objects rather than images. 

In such a program, the objects on 
screen are typically equipped with "han- 
dles" which may be moved using the 
mouse to redefine the location and size 
of the figure. You can also edit such at- 
tributes as color, line type and size, and 
fill pattern. In each case, the user's ac- 
tion results in a modification of the 
stored VDI command sequence, which is 
then replayed in whole or part to re- 
generate the picture on the screen. In 
most of these programs, you can also 
group sets of drawing objects, which 
may then be scaled and edited together. 

Beyond simple screen editing, many 
other types of programs are made possi- 
ble with the concept of graphical objects. 
For instance, objects can be linked up to 
fields or records of a database. The re- 
sult is a point-and -click information re- 
trieval system. This approach is best 
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OPCODE 


SUB-OPCODE 


VDI CALL 


FUNCTION 


VDI 


3 


- 


v_clrwk 


Clear Workstation 


4 


_ 


v_updwk 


Update Workstation 


METAFILE 


5 
5 


2 
3 


v_exit_cur 
v_enter_cur 


Exit Alpha Mode Escape 
Enter Alpha Mode Escape 


COMMANDS 


5 

5 


20 
21 


v_form_adv 
v_output_window 


Advance Form 
Output Window 


FIGURE 3. 


5 


22 


v_clear_disp_list 


Clear Display List 


exemplified by the Filevision package 


5 


23 


v_bit_image 


Output Bit Image File 


available for the Macintosh. 


6 


- 


v_pl!ne 


Polyline 


^B JB ^V e have so far assumed chat 


7 


- 


v_.pmarker 


Polymarker 


V^ftV the location, size, and shape 


8 


- 


v_gtext 


Graphic Text 


wiv 


9 




v_fillarea 


Fill Area 


^B ^m 01 the objects are under 










user control. If these values are instead 


11 


1 


v_bar 


Bar 


determined by the program, we get an- 


11 


2 


v__arc 


Arc 


other family of applications. 


11 


3 


v_pieslice 


Pie 


When the values are computed from 


11 


4 


v„circle 


Circle 


underlying data, the result is a data 


11 


5 


v_ellipse 


Ellipse 


graphing application. Such a grapher 


II 


6 


v__ellarc 


Elliptical Arc 


might also allow you to manipulate han- 


II 


7 


v_ellpie 


Elliptical Pie 


dles on the objects forming the graph, 


II 


8 


v_rbox 


Rounded Rectangle 


and cause a change in the related values. 


II 


9 


v_rfbox 


Filled Rounded Rectangle 


You could also write a program 


II 


10 


v_justified 


Justified Graphic Text 


which would relate each object's loca- 
tion, size, and shape to those of the 


12 
13 


- 


vst_height 
vst_rotation 


Set Absolute Character Height 
Set Character Baseline Vector 


other objects on the screen. For in- 










stance, you might force two lines to lie 


14 


- 


vs_color 


Set Color Representation 


parallel, or to be of equal length. Such 


15 


- 


vsl_t}'pe 


Set Polyline Type 


"constraint based" graphics editors are as 


16 


- 


vsUwidth 


Set Polyline Line Width 


old as Ivan Sutherland's original Sketch- 


17 


- 


vsLcolor 


Set Polyline Color Index 


pad program, and are available in some 


18 


- 


vsm„type 


Set Polymarker Type 


CAD packages, but have yet to appear 


19 


- 


vsm_height 


Set Polymarker Height 


on machines of the ST's size and price. 


20 


- 


vsm_color 


Set Polymarker Color Index 


As a final idea, consider a program- 


21 


~ 


vst_font 


Set Text Face 


ming language which would include 


22 


_ 


vst„color 


Set Text Color Index 


graphic objects in its command set and 


23 


_ 


vsf_interior 


Set Fill Interior Style 


workspace. In such a language, you 


24 


_ 


vsf_style 


Set Fill Style Index 


could write routines to compute objects' 


25 


_ 


vsf_color 


Set Fill Color Index 


appearances as the result of a simula- 
tion. The results might range from 


32 


- 


vswr_mode 


Set Writing Mode 


simple animation sequences, such as 


39 


- 


vst„alignment 


Set Graphic Text Alignment 


a bouncing ball, to very complex situ- 


104 


- 


vsf_perimeter 


Set Fill Perimeter Visibility 


ations like a rendezvous with a space 


106 


- 


vst_effects 


Set Graphic Text Special Effects 


station 


107 


- 


vst_point 


Set Character Height, Points 


Whatever the application envisioned. 


108 


„ 


vsl_ends 


Set Polyline End Styles 


a program which uses graphic objects 


112 


- 


vsf_updat 


Set User-defined Fill Pattern 


must be able to read as well as write 


113 


- 


vsl_udsty 


Set User-defined Line Style Pattern 


metafiles, because that is the format 


114 


_ 


vr_recfl 


Fill Rectangle 


in which graphical commands will be ► 


129 


- 


vs_clip 


Set Clip Rectangle 
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USING 
FONTS 
WITHOUT 
GDOS 

The following technique will let you 
load and use alternate fonts without 
using GDOS. Your font must be in the 
standard format (including header) as 
defined in the VDl manual. Either com- 
pile the font intoyour application, or load 
itfrom afile at run time. 

Instead of doing the normal \st^load 
_/onts call, you will alter your applica- 
tion's control array directly. Control 

5torcd, This requires a more detailed un- 
derstanding of [heir formac, because the 
VDi does not provide an input function. 
The definitive document on metafile for- 
mat is currently the GEM VDl manual, 
but the following paragraphs should pro- 
vide enough information to allow you to 
do some exploration. 

STRUCTURE 

The metafile is composed of a header 
followed by an arbitrary number of com- 
mands. Each command consists of at 
least four words, and is generated by one 
of the functions given in the table in fig- 
ure 3. The first word in the four is the 
command opcode. The second word is 
the number of vertices in the command. 
This field is used with the polyline and 
polymarker commands, for instance. 
The third word is the number of integer 
parameters required for the command. 
The fourth word is the sub-opcode, 
when it is required. If any of the last 
three fields are not used for the com- 
mand, they are forced to zero. 



words 7 and 8 must be a 32-bitpointer to 
the font. Control words JO and U are a 
32-bit pointer to a scratch buffer which 
will be used by the VDI when doing spe- 
cial effects such as hold or italics. Control 
word 9 must be set to the length in words 
of this buffer. The buffer should be at 
least four times the size of the largest 
character in the font. 

After setting up the control array, you 
should he able to select the font using the 
set_font function. When you are done 
with the font, or with your program, do a 
regular vst_unload_fonts call so the 
VDl doesn't continue to think the font is 
available. 

(Thanks to John Feagens of Atari for 
this information.) 

Immediately following the required 
four words are the vertices, if any were 
specified. This is an image of the ptsin|] 
binding array associated with the VDl 
function which created the command. 
After the vertices, the integer param- 
eters, if any exist, are written. They are 
an image of the intin[] binding array 

The close workstation command 
forces a final single word command to 
be written at the end of the metafile. It 
is a word of all ones (hexadecimal 
FFFF). 

The standard metafile header consists 
of 14 words. Only the first four are re- 
quired. The first word is a tag value, 
again hexadecimal FFFF. The next word 
is the length of the header in words. The 
third word is a version tag, and the next 
word shows whether the metafile work- 
station was opened for Raster Coordi- 



nates (RC), or Normalized Device 
Coordinates (NDC). 

The remaining entries in the header 
provide information which will help 
OUTPUT.PRG when it attempts to re- 
generate the drawing on another device. 
You may set them using VDI calls after 
opening the metafile workstation. If they 
are not set, they are filled with zeros, 
and OUTPUT will use default values to 
generate the display. 

The first four optional values define 
(in order) the minimum and maximum 
X and Y coordinates to be found in the 
metafile. This allows OUTPUT to bound 
the space in which graphics will appear. 
Your application may set these values 
with the v_meta_extents call. 

The next two words in the header are 
the physical page size on which the 
graphic should be reproduced. The units 
are tens of millimeters, and the values 
are given in width-height order. While 
Appendix H of the VDI manual de- 
scribes this call, there is no standard 
binding provided, so you will have to 
write your own if you wish to use it. If 
you do not set this value, OUTPUT will 
do its best to fit the drawing onto the 
target device, using the assumption that 
its pixel elements are square. 



The final four words in the header 
may be used to define the coor- 
dinate space for the metafile. 
They contain, in order, the X and Y co- 
ordinates of the lower left corner of the 
drawing area, and the X and Y values of 
the upper right corner. These values are 
mapped onto the drawing area as de- 
fined in the last paragraph. Again, there 
is no standard binding for this function, 
but it is described in the VDI appen- 
dices. If the information is omitted, 
OUTPUT will use a default raster or 
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normalized coordinate space, depending 
on how the metafile was opened. 

As a last refinement, consider the 
v_write_meta VDI function. This 
works only with metafiles, and allows 
you to insert commands of your own 
definition into the metafile. This ca- 
pability could be useful, for instance, in 
establishing the data/object relationships 
in the applications proposed earlier. 

If you use this ability, you must avoid 
sub-opcodes 10, 11, 50, 51, and 81, 
which are used by Digital Research's 
GEM Draw program. These codes are 
given special handling by OUTPUT; 
their functions are defined in the VDI 
appendices should you wish to use 
them. With these exceptions, OUTl'UT 
will ignore commands inserted with 
v„write_meta, since it has no idea how 



they should be interpreted. You may also 
encounter problems if the metafile is 
later edited using a graphics program 
which does not understand your special 
commands. In most cases, the informa- 
tion will be lost in the editing process. 
In this article, I have tried to show 
how GDOS and metafiles fit into the 
framework of the ST's software, and how 
they can be used to avoid wasting effort 
on rewriting of device drivers. If more 
applications appear which use the 
GDOS, it should encourage manufac- 
turers of printers and other peripherals 
who want to sell to the Atari market to 
write drivers compatible with GDOS. 
This can save us all time which can be 
better spent on programs that stretch 
the abilities of the ST ■ 
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'M^ There is a difference between paint 
and draw programs. Paint programs 
are recreational packages that 
ry ' .^^y //// allow freeform painting on a dot-by- 
^^S^^^ dot basis. With each new stroke you 

' obliterate everything you cover. And 

erasing permanently removes everything 
you've created. 

An object-oriented drawing program like 
Easy- Draw is a versatile, powerful tool you use to 
create business graphics, presentation 
materials, line drawings complex 
illustrations on a figure-by-figu: 
basis. It lets you: lay down 
solid or transparent 
figures to build 



composite drawings • size, move and manipulate 
objects individualiyand collectively -use a grid 
.system for controlled, precise scale drawings 

• produce print-ouls with accuracy _^ 
exceeding your screen images f \ — --, 

• create custom drawings easily. y&uY^ ffjyi 
Ask your dealer for 
Easy- Draw, the drawing 
program for 
professionals. 
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JUST HOW USEFUL IS THE ST? 



by Jack Powe 



ASSOC 



When it comes to everyday 
applications— word proc- 
essing, spreadsheets and 
databases — how practical is the ST? 
The 520ST has been available for almost 
a year and there is no longer any ques- 
tion of support from a growing list of 
software producers. But what programs 
actually transform this 68000-based 
bargain box into a viable, practical tool? 
START examined practical ST prod- 
ucts in three major categories: word 
processors, databases and spreadsheets. 
Synopses by category and by product are 
based on the opinions of START editors, 
plus those of several outside reviewers 
who tested these products for Antic 
magazine. ST programming languages 
are also examined as they are the tools 
by which "practical" products are 
created. 




ILLUSTRATIONS BY MACIEK ALBRECHT 



If a product was reviewed in Antic, 
we include the date of the review. Prod- 
ucts marked "FINAL" are currently avail- 
able. To indicate the future direction of 
practical ST software, we have included 
announced products, labeled "PRESS," 
for press release. Unless otherwise 
noted, all editorial commentary is made 
on products which are in final release 
state and have been submitted for re- 
view. If a product is copy protected, it is 
so noted, START welcomes comment 
and rebuttal from both users and 
manufacturers, 

AN OVERVIEW 

ST word processors range in price from 
$145 to absolutely free. At the high end. 
Final Word, from Mark of the Unicorn, 
is the only really full-featured word 
processor currently available. But it is a 
throwback to the mainframe systems 
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and unforgivably complicated on a ma- 
chine designed for friendly interface. At 
the other price extreme, 1ST Word, from 
Atari, is more in the ST style. It is 
mouse driven, has plenty of GEM win- 
dows and bright graphics, but it doesn't 
support such elementary print com- 
mands as line spacing. Verdict; the Atari 
ST still lacks a powerful, up-to-date 
word and document processor that takes 
advantage of the machine's architecture. 

Users of dBase 11/111 will be right at 
home on the ST. With both H & D 
Base, from Mirage Concepts, and 
dBMAN, from VersaSoft, on hand, many 
currently available dBase II/Ill programs 
may be ported directly to the Atari ST, 
Those who find dBase-type databases 
unnecessarily complex may prefer the 
simplicity of DB Master One, from Atari. 
ll is not, however, relational and has 
very limited report capabilities. Again, 
the former programs are all-text, IBM 
clones, while the latter is simple and 
uses friendly GEM. ST owners are still 
waiting for such friendly powers as 
Ribase 5000 or Framework. 

What? Only two spreadsheets? That's 
right. Early press releases from several 
companies touted Lotus 1-2-3 clones 
they were preparing for the ST, Only 
VIP came through with a product. The 
pattern continues here: the all-text, 
powerful VIP, and the simpler, GEM- 
based A-Calc. 

Languages are included in this over- 
view to show that tools exist to create 
new software. There are plenty of lan- 
guages for the Atari ST. Unfortunately, 
all are primarily designed for developers. 
Currently, no languages are available for 
the hobbyist or casual user. ST LOGO 
and ST BASIC are hopelessly clumsy. 
The remaining languages are compilers, 
most with complicated linking pro- 
cedures and numbing compile and link 
time. The ST desperately needs a lan- 
guage that is fun to use, like Turbo Pas- 
cal, or ACTION! on the 8-bii: Atari's. 



WORD PROCESSORS 

1ST Word 

Atari Corp., 1196 Borregas Avenue, 
Sunnyvale, CA 94086, 

(408) 745-2000 

Free 

FINAL 

This fully GEM-based word processor — ■ 
which is bundled with the 1040ST and 
5205T — is currently the best, entry- 
level, GEM-based word processor. It also 
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works nicely as a programmer's text edi- 
tor. Limitations in print formatting fea- 
tures — including the inability to print in 
anything other than single-space— de- 
tract from this otherwise excellent prod- 
uct. Any company planning to charge 
money for a word processer has stiff 
competition here. Not copy protected. 
(Antic review 6/86) 

Final Word 

Mark of the Unicorn, 222 Third 
Street, Cambridge, MA 02142, 
(617) 576-2760 
$145.00 

FINAL 

A thorough — but pricey — text-oriented 
word processor/document processor. De- 



scribed by our reviewer as a clone of the 
IBM PC Perfect Writer, this is an entirely 
command-driven word processor with 
no GEM interface. The program, which 
uses virtual memory, is packed with fea- 
tures including multiple- buffers. It was 
found to be powerful, but difficult to 
learn. The documentation, as well as the 
program, reflects the fact that Final 
Word was a straight port from IBM and, 
in many cases, does not take advantage 
of the ST's individuality. Copy protected. 
(Antic review 4/86) 

Let's Write 

Mark Williams, 1430 W, Wrightwood, 
Chicago, IL 60614, (312) 472-6659 
$99,95 

FINAL 

Essentially, this is Micro EMACS with 
word-wrap — which is familiar to most 
ST developers since it was provided, in 
one form or another, with the ST devel- 
oper's package. (EMACS was a popular 
programmer's text editor on mainframe 
systems.) Let's Write is an entirely com- 
mand-based program that is obviously a 
throwback to the Unix mainframe sys- 
tems. The package includes a spell 
checker, and the Kermit telecommunica- 
tions module (which was also supplied 
with the developer's kit). Not copy 
protected. 

HabaWriter 

Haba Systems, 6711 Valjean Avenue, 
Van Nuys, CA 94106, (800) HOT 
HABA (US), (800) FOR-HABA (CA) 
$74,95 
FINAL 

HabaWriter was the first GEM-based 
word processor for the ST. Ian Chad- 
wick, who reviewed it for Antic, found 
version 1.0 to be buggy and mosdy 
unusable. Since then, Haba has released 
version Ll, which has not yet been eval- 
uated. Copy protected. (Antic review 
3/86) ► 
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Express 

Mirage Concepts, 4055 W. Shaw, #8, 
Fresno, CA 93711, (800) 641-1441 
$49,95 
FINAL 

Express is a "letter processor," limited in 
word processing capabilities and de- 
signed primarily for simple letter output 
with mailmerge. This was the hrst word 
processor available for the ST and, as 
such, was roundly — and unfairly — con- 
demned by the new ST community Ex- 
press is not really a word processor but 
is designed as an easy-to-use letter de- 
signer with simplified mailmerge system. 
As such, it works fine. Not copy pro- 
tected, (Antic review 1/86) 

HomePak 

Batteries Included, 30 Mural Street, 
Richmond Hill, Ontario, CANADA 
L4B 1B5, (416) 881-9941 
$69.95 
PRESS 

Integrated word processor, terminal pro- 
gram, and database fashioned after the 
popular 8-bit program of the same name 
by Russ Wetmore. Batteries included 
plans to have this product on the market 
by June 1986. 

ST Writer 

Atari Corp., 1196 Borregas Avenue, 

Sunnyvale, CA 94086, 

(408) 745-2000 

Free 

FINAL 

John Feagans and a team of Atari pro- 
grammers got fed up waiting for a word 
processor to come out for the early ST's. 
So they re-wrote the code of the 8-bit 
Atari Writer program and got it up and 
running on the ST (all in two weeks, it 
is rumored). The program can currently 
be found on CompuServe and in several 



user's group libraries. We use this pro- 
gram in-house, partly because it can 
adapt to most of the many incompatible 
text formats available on the ST. 




DATABASES 

H & D Base 

Mirage Concepts, 4055 W. Shaw, 
Fresno, CA 93711, (800) 641-1441 
$99.95 
FINAL 

A dBase II clone (80% compatible). The 
first "serious" available ST database. 
Fashioned after dBase II, H & D Base 
can use dBase II command programs 
ported from other machines. Also, most 
of the many dBase II books found in 
stores will apply to this program. Inter- 
estingly, since H & D Base was written 
in Forth, the programmers have left in a 
command to "turn on" the Forth kernel 
so you can program in Forth as well as 
H & D Base. In April 1986, some bugs 
were being ironed out of the first re- 
leases, but customer support seems to 
be excellent- Not copy protected. (Antic 
review 7/86) 



dBMAN 

VersaSoft, 723 Seawood Way, San 
Jose, CA 95120, (408) 268-6033 

S149,95 
FINAL 

dBMAN is currently the only available 
relational database for the ST which is 
compatible with both dBase II and 
dBase III. The final package arrived in 
our offices in April 1986, too late for re- 
view. An introductory price of $99.95 
will be offered until July 1st, Not copy 
protected. 

DB Master One 

Atari Corp., 1196 Borregas Avenue, 
Sunnyvale, CA 94086, 
(408) 745-2000 
$49.95 

FINAL 

This easy to use, non-relational, GEM- 
based database was packaged with the 
ST during December, 1985. DB Master 
One is an excellent "simple" database. It 
is very fast and easy to use with limited 
reporting capabilities and field types. 
Stoneware plans on releasing packages 
that will increase the complexity of this 
database. In the meantime, this is a very 
good package for organizational uses. 
Not copy protected. (Antic review 6/86) 

Zoomracks 

Quickview Systems, 146 Main Street, 

Los Altos, CA 94022, 

(415) 965-0327 

$79.95 

FINAL 

Zoomracks is an oddity. Based on the 
structure of rack cards (such as "punch- 
in" time cards), this program is more a 
data organizer than a true database. 
Currently there are no mathematical ca- 
pabilities. The card rack metaphor 
would seem an excellent use of GEM, 
but Zoomracks is another IBM PC port 
which does not use GEM, The screen 
has a cluttered appearance. The success 
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or failure of [his product will depend 
upon the willingness of ST owners to 
adapt to its unusual metaphor- — assum- 
ing that metaphor works. Not copy pro- 
tected. (Antic review 6/86) 

Hippo Simple 

Hippopotamus Software, 

985 University Avenue, Suite 12, 

Los Gates, CA 95030, (408) 395-3190 

$49,95 

FINAL 

An "easy to use" home database, found 
by our reviewer to be frustrating and 
confusing — mainly because of the poor 
documentation. Version 1.0 seemed to 
"have been rushed to market a little too 
quickly" Copy protected. (Antic review 
3/86) 

The Manager 

BMB Compuscience Canada, 500 
Steeles Avenue, Milton. Ontario L9T 
3P7, Canada, (416) 876-4741 
$169.95 
PRESS 

The Manager is allegedly the power- 
house relational database system ST 
owners are waiting for. Its firm de- 
scribes it as a "paperless office". The im- 
plication here is that this product will 
eliminate the need for paper in your of- 
fice. Well . . . we'll see. The product was 
first demonstrated at the November 
1985 COMDEX m Las Vegas. It looked 
pretty impressive — but still no GEM, 

db One 

Oxjd, 3428 Falcon Avenue, Long 
Beach, CA 90807, (800) 453-4900 
$59.00 
PRESS 

A relational database which is promised 
to mclude mailing list, labeling, check- 
book, and inventory. 



SPREADSHEETS 

VIP Professional 

VIP Technologies Corp., 132 Aero 

Camino, Santa Barbara, CA 93117, 

(805) 968-4045 

S179.95 

FINAL 

VIP Professional is allegedly compatible 
with Lotus 1-2-3, and is currently the 
only full- featured, heavy-duty spread- 
sheet for the ST. This product tumbled 
through some rough PR waters during 
its release and is still suffering from a 
legal fight between parent company, VIP 
Technologies, and Shanner International, 
the marketing firm hired by VIP to 
launch their product. Originally prom- 
ised — and advertised — as a GEM prod- 
uct with windows, the "mouse" version 
of VIP had not yet appeared in April 




1986. The Antic reviewer found this to 
be a good product — if a little slow. Antic 
also recommended any buyer contact 
VIP and be sure of fuh customer support 
before purchase is made. Copy pro- 
tected. (Antic review 5/86) 



A-Calc 

The Catalog, 524 Second Street, 
San Francisco, CA 94107, 
(800) 443-0100 Ext. 133 
$59.95 
FINAL 

A-Calc is a GEM-based spreadsheet cre- 
ated in Great Britain which holds 256 
columns and 512 rows. This mouse- 
driven spreadsheet is easy to use, but 
not as complete as a Lotus 1-2-3 system. 
Not copy protected. 

LANGUAGES 

MegaMax C 

Megamax, Box 851521, Richardson, 
TX 75085, (214) 987-4931 
$199.95 
FINAL 

Full, one-pass C compiler with editor 
and "smart" linker. Arguably the finest C 
compiler available for the ST, this pack- 
age is currently crippled by a 32K array 
dimension limit and a 32K code limit. 
These limitations — which the company 
promises to repair — are imposed by the 
Macintosh OS, from whence this system 
was ported. Compile and link time is 
extremely fast and end code is relatively 
small. In most cases, MegaMax C is 
compatible with Alcyon C, The price, 
however, is pretty hefty For another 
$100, you could get the developer's 
kit — and all the GEM documentation. 
Not copy protected, 

Metacomco Lattice C 

The Catalog, 524 Second Street, 
San Francisco, CA 94107, 
(800) 443-0100 Ext. 133 
$149.95 
FINAL 

A complete development C Lattice C is 
the industry standard C and currently 
the only commercially available ST C 
which is at least as complete as Alcyon 
C in the developer's toolkit. Its linker, ^ 
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SOFTWARE . . . 

however, is not completely compatible 
with Alcyon's. Not copy protected, 

GST-C 

The Catalog, 524 Second Street, 
San Francisco. CA 94107, 
(800) 443-0100 Ext. 133 
$79.95 
FINAL 

This C implementation is easy to use 
and includes a 1ST Word-type editor 
and GEM shell An added bonus is the 
excellent "superstructure library" which 
simplifies many GEM commands much 
like OSS's Personal Pascal. Major short- 
coming: no floating point and uses same 
link as Lattice C which, therefore, 
makes it incompatible with Alcyon C 
Not copy protected. 

Haba Hippo-C 

Haba Systems, 6711 Valjean Avenue. 
Van Nuys, CA 91406, (800) HOT- 
HABA (US), (800) FOR-HABA (CA) 
$59.95 
FINAL 

You get what you pay for when you buy 
Haba Hippo C, the least expensive of 
available ST C's . It does not support 
floating point arithmetic and contains a 
number of compatibility problems, many 
due to its UNIX-like shell called HOS. 
Few ST-specific C programs written in 
the developer's Alcyon C will compile 
properly in Hippo-C. Unfortunately, this 
was the first commercially available C 
for the ST market and a lot of owners 
snapped it up. Copy protected, (Antic 
review 2/86) 

Personal Pascal 

Optimized Systems Software, 1221-B 

Kentwood Avenue, San Jose, CA 

95129, (408) 446-3099 

$74.95 

FINAL 



Personal Pascal is the closest thing to a 
friendly language that currently exists for 
the ST It is also one of the only lan- 
guages to include detailed documenta- 
tion on how to access and use the 
complex GEM VDI and AES commands. 
In another first, its editor actually in- 
cludes an auto-indent feature, helpful in 
structured program formatting. From ex- 
perience, we can add that any product 
purchased from this company includes 
excellent customer support. Not copy 
protected. (Antic review 5/86) 




Metacomco Pascal 

The Catalog, 524 Second Street, 
San Francisco, CA 94107, 
(800) 443-0100 Ext. 133 
$99.95 
FINAL 

A full, ISO 7185 standard which com- 
piles to native code. Not copy protected. 

Modula-2/ST 

TDI Software Ltd., 1040 Markison 

Road, Dallas, TX 75238, 

(214) 340-4942 

$149.00 

FINAL 



Created by Professor Niklaus Wirth, the 
inventor of Pascal, ST owners are truly 
lucky to have an opportunity to try this 
new language. Our reviewer found this 
to be a generally solid implementation of 
the language, though with weak docu- 
mentation (particularly of the GEM sys- 
tem), and clumsy user interface. Not 
copy protected. (Antic review 5/86) 

H & D Forth 

Mirage Concepts, 4055 W. Shaw, 
#108. Fresno, CA 93711, 
(209) 227-8369 
$39.95 

FINAL 

An 83-standard Forth with access to all 
GEM commands as well as BIOS and 
XBIOS commands. Holmes & Duck- 
worth used this Forth for in-house de- 
velopment of such products as H & D 
Base. This is a "best buy" for ST Forth 
programmers- It deviates from 83-stan- 
dard in that the stack is 32-btts wide, so 
there are no double words, and multiple 
dictionaries are not allowed. Otherwise, 
H &r D Forth is very thorough and rea- 
sonable. Remarkably, no royalties need 
be paid for professional development 
with this product. Not copy protected, 
(Antic review 6/86) 

4xForth 

The Dragon Group, 148 Poca Fork 

Road, Elkview, WV 25071, 

(304) 965-5517 

$99,95 

FINAL 

An 83-standard developer's Forth which 
includes limited multi-tasking capabili- 
ties. 4xForth was the first commercially 
available language for the ST (not count- 
ing developer's C and LOGO), Customer 
support seems to be excellent with this 
company. By April 1986, however, free 
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Forchs are beginning to appear in public 
domain, and H & D Forth certainly 
seems a comparative value. Not copy 
protected. (Antic review 12/85) 

Cambridge LISP 

Metacomco, 26 Bristol Square, Bristol, 
United Kingdom BS2 8RZ 
$199,95 
PRESS 

This is the only LISP currently planned 
for ST, After some delay, Metacomco still 
plans releasing this language for the ST 
You can expect it late summer or early 



DevPacST 

HiSoft, 180 High Street North, 
Dunstable Beds, United Kingdom 
LU6 lAT (0582) 596421 
$79,95 

FINAL 

A complete assembler- editor system. 
(See Christopher Chabris" review, this 
issue of START) Not copy protected. 

A-Seka 

The Catalog, 524 Second Street, 
San Francisco, CA 94107, 
(800) 443-0100 Ext. 133 
S39.95 
FINAL 



A high-speed, fully RAM-based as- 
sembler with debugger. (See Christopher 
Chabris review, this issue of START.) 
Not copy protected. 

GST-ASM 

The Catalog, 524 Second Street, 
San Francisco, CA 94107, 
(800) 443-0100 Ext. 133 
$59.95 

FINAL 

GEM-based assembler/editor. (See 
Christopher Chabris review, this issue of 
START.) Not copy protected, ■ 
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ATARI 520 ST 

PERSONAL COMPUTER SYSTEM 

$839.95 with Color Monitor 

The Alari 520 ST Comes Camptete With: 

ST LOGO'" and ST BASIC" to create [irograms 

1ST WORD 15 [he period wordprocessieg package for al 

NEOchrome Sampler is a tuii color pajming progra 




2nd Drive For Only $69.95 ";?«« 

When you buy the cnmplEte 520 ST, SF 354 Drive it Monitor System 
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ProCopy 

INTRODUCTORY OFFER 

§24-9* ST;?,tr,r 

Regular S34.96 Offer ends July 31, 1986 

Software can easily be damaged by heat, tiumidi- 
ty, nnagnetic fields, wear & tear or just dirt. The ex- 
posed surface of a disk can be affected by even a 
touch. The best wdy to preserve your software is to 
moke backups. ProCopy provides the solution, 

■ Duplicates virtually any protected disk. 

■ Reasonable update policy available. 

■ Protects against accidental loss of 
expensive software. 

■ Not copy-protected for your convenience. 

■ ProCopy works on all Atari ST computers, 
ORDER TODAY AT THIS REDUCED RATE 

Send S24,95 (check or money order). VISA hhhj 

& MC accepted. Add S2.00 shipping & ^gy 

handling in U.S. & Canada. Overseas ship- " ' ; 

ping & handling add S4.50. LiJ 

AlQfi ST lb □ legislated Irademork ol Alari Cciip. 1 ^-^ — ^ 1 

Available Only From 

PRCw ,*ti£TS 

PC BOX 665 

CHEPACHET, RHODE ISLAND 02814USA 

(401) 56B-B459 
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ISK INSTRUCTIONS 



■ Jl #elcome to the START Disk Directory. All program 
If If listings referred to in this issue are on your START 
W W disk, which is provided in a special envelope bound 
into the magazine. We recommend you read articles related to 
the programs on the disk before attempting to run the pro- 
gram. If you just can't wait, jump on down to FAST START, (If 
you purchased the S4 version of START, without disk, you can 
still purchase the disk by sending S10.95 for disk, plus $2,00 
for postage and handling, to START DISK, 524 Second St., San 
Francisco, CA 94107.) 

Use a pair of scissors to open your disk envelope along the 
outside vertical edge. Remove your START disk, place it in 
your disk drive and click the disk icon to see its contents. 
(Please refer to your ST owners manual if you are uncertain of 
proper Desktop procedures.) 

Your START disk contains six folders, each with programs, 
listings and data related to its particular START article. A run- 
nable version of each program (usually recognized by its .PRG, 
or ,TOS extender) is included, along with all related source 
code. Also, each folder contains a ,BAT "batch" file specific to 
its program. Detailed information on the batch files and pro- 
gram compilation is contained in README.TXT All programs 
were tested and compiled with developer's Alcyon C on a 
520ST with TOS in ROM, 

The START disk is single-sided and very full. We recom- 
mend transferring programs you wish to try to another disk. 
Desk Accessory programs with ,ACC extenders must be trans- 
ferred from their folders and placed on a "boot" disk before 
they will operate properly. 

FAST START 

Write protect your START disk before trying any programs. 
Slide the disk tab until you see light through the litde hole. To 
be really safe, make a back-up copy of your disk, 

COLRMOVR,STQ: Joe Chiazzese's demonstration of 16- 
color icon movement works only in low-resolution. Open the 
folder and click on NEWMOUSE,PRG, Your screen will show a 
karate character which may be moved with the mouse. Exit 
the program by pressing |Esc], NEWMOUSE.C is the C 
source code; COEUTIL,S, the AL source code; KARATE.S, the 
karate character bit image; and NEWMOUSE,BAT, the batch 
file for compilation. 

MAGNETS.STQ: David Small's magnetic field line pro- 
gram will work in any resolution. Click on MAG2TPRG and 
read the instructions in David's article. MAG21,C is the C 



source code of the program, and MAG2LBAT the batch file, 

MIDISEQR.STQ: You'll need a MIDI-compatible synthe- 
sizer for this. Hook up both input and output lines between 
synthesizer and computer. Click on SEQUENCR.PRG to 
run the program, then read Tom Jeffries' article for 
instructions. Two demonstration songs, ARABESQU.SNG and 
ENTRTAIN.SNG, have been included, courtesy of 
Micro-W Distributing, Inc. Please print (c)NOTICE to screen 
or printer for important information. SEQUENCR.C is the 
main source code and SEQUENCR.BAT the batch file. 

PRNTDRVR.STQ: Tom Hudson's program is a Desk 
Accessory which must be transferred to a boot disk. It will 
only work with TOS in ROM. Transfer INSTALL.ACC, and 
any of the ,PRT files which match your printer. We have 
included four driver files: EPSON.PRT, for Epson printers; 
PROWTR.PRT, for NEC/Prowr iters; CGP220/PTR, 
for the Radio Shack color printer; and OKI20C,PRT, for the 
Okimate-20 color printer. Please note, the Okimate-20 driver 
is for those Okimates configured with standard IBM interfaces. 
Many more drivers may be found on CompuServe (see article). 
Your local Atari user group may be helpful if you can't get on 
CompuServe, Once you have transferred the above files and 
booted the disk, you will find "Printer Driver" in the drop- 
down Desk menu. Complete instructions may be found in 
Tom's START article. INSTALLC ts the C source code; IN- 
STAL.S is source for the AL routines; EPSGN.S and JX80C,S 
are sample printer driver sources; SAVER.C is source for the 
printer driver generator; and INSTALL,BAT and SAVER,BAT 
are batch files. 

ROUTINES,STQ: Dan Matejka's C and AL routines may 
be tested by clicking on PRTSHELL,PRG, This program will 
call FILE.ONE and FILE.TWO, so they must be on the same 
disk as PRTSHELLPRG PRINTOUTC is the main C source 
code; MEMOPS.S, the source for the AL routines; 
PRTSHELL,C, is C source for the demo shell program; and 
PRTSHELL,BAT the batch file, 

GEMTEXT.STQ: To run Corey Cole's GEM text demon- 
stration, you will need both TEXTDEMO,PRG and 
TXDEMO,RSC on the same disk. Click on TEXTDEMO,PRG 
and follow the instructions in Corey's article. TEXTDEMO,C 
is the main C source code; TEXTDEMO.H, the defines for 
TEXTDEMO.C; TXDEMO.C and TXDEMO,DEE are 
resource file sources; TXDEMO.H is the resource file header; 
TEXTDEMO,BAT, the batch file; and DEBUG.C is a 
generic debugging aid, ■ 



STaht. the ST Qiiarlerly 



17031 644-SSS1 



fOO R Fffi TITLE FOR P^H 



Tired of ganes, databases, spreadsheets, and writing letters on aour new 

SmTor lemi. Uhat do you do with your NEOCHROHE and DEGAS artwork? 

Heicone to XLEHT Software's CREflTILITIES for the ATARI ST. 



TWESETTaST 



ROHEI STAMP ST ^ HEtAFMT ST i ST HKIC NX 



!■ r.bi^..Miiiig i^^awww 



TVPESETTER ST by dorfhan t voung 
This CSESIM package is United mis bs Hour ovn inagination. 
* Conplete page designing flexibility « Use your DEGftS and 
NEOchroHe art » HIGH resolution printouts * Use custoH fonts » u 
Supports both color and Hono * Print to Epson w/Graftrax, NEC, '^ 
Prowriter, Panasonic, GeHini, SG and conpatibles. * $39.95 * 



RUBBER SIMP ST by voung t dorfmrn ^^ 
Hanipulate your artwork: Expand * Shrink « Rotate « Flip «^ 
Mirror * Add text * Fill » Overlay and Hore » Create ads . 
logos. Typesetter ST icons..., Print half page, labels, index i i>(/ 
Rolodex cards. » S39.95 » 




NEEAFHT ST uy dellinger t rognlie 
Print text files in different 
fonts, print graphics in Multiple 
sizes, create fonts. $39.95 



NEOCHROHE is i trjdf BsrK of RTRRI 

DEGAS IJ S trjd! MfK of batteries INCLUDED 



THIS flD WAS CREATED USING TfKSETTEt 



ST HUSIC BOX ty DORFHflH i votiw 
« House driven editor » Aninated player* 




* Conpose in up to 8 voices * S49.95 * 
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SOPHISTICATED 

TEXT HANDLING 

A Window On GEM Special Effects 



by Corey Cole 



H 



ow to manipulafe 
text in GEM. A thorough 
investigation of sophisti- 
cated text handling. 
Technical tips — and pit- 
falls to avoid. Including a 
full-featured C program 
that lets you test all pos- 
sible GEM text capabili- 
ties. Related files may 
be found within the 
GEMTEXT folder on your 
START disk. 
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, efore the advent of Apple's 
. Macintosh, microcomputer pro- 
grammers had an easier time 
using text in their programs. Computer 
screens generally could only display a 
single font. As computers became more 
sophisticated, users began to expect 
more from them: the Macintosh deliv- 
ered reasonably priced proportional 
spacing and multiple type fonts. 

Thanks to GEM, the Atari 520ST has 
many of the advanced text display fea- 
tures previously found only in expensive, 
dedicated publishing systems. Let's ex- 
plore the use of some of these. 

USING GEM TEXT 

GEM helps programmers by doing much 
of the hard work needed for sophisti- 
cated text display You can ignore most 
of gem's overwhelming set of opera- 
tions for displaying and dealing with 
graphics text. If you are just trying to 
display plain text in a window, you only 
have to worry about where to put it. Be- 
yond that, you can use as many of the 
more advanced features as you need. 

Think of GEM'S VDl calls as a tool- 
kit; the basic set of tools for text consists 
of only seven VD! calls. The calls 
v_gtext and v_justified actually display 
the text. You can set text size in pixels 
with vst_height, or in points (a typog- 
rapher's unit measuring 1/72 of an inch) 
with vst_point. The vst„effects call 
specifies characteristics such as boldface, 
italics, underlining, outlining, shadow- 
ing, and "light" (grey shading); vst_ 
alignment positions and aligns the text. 
You can check the width of a string or of 
a single character with vqt_extent and 
vqt_width. 

Depending on your application, you 
may need vst_rotation and vst_color 
(which set baseline rotation and fore- 
ground/background colors), and vqt_ 
attributes (which returns the charac- 
teristics of the current typestyle). Once 
the final GDOS becomes available (see 



"GDOS & Metafiles" by Tim Oren, this 
issue), you may have use for vst_load 
_fonts, vst_unload_fonts, and vst_ 
font — which allow you to deal with 
proportionally spaced and alternative 
typestyles. Finally, you may need vswr 
_mode and v_bar to deal with "re- 
versed" (white on black) text or italic 
characters, and vs_clip to keep your 
text in the window. 

Unfortunately, there is a darker side 
to the ST's GEM, Several of the above 
features were omitted from the Atari 
version of GEM; others have bugs, A few 
features crucial to some applications 
never found their way Into GEM at all. 



is a multiple of eight). You should use 
the "Replace" writing mode and, when- 
ever possible, try to do your own clip- 
ping (rather than relying on the vs_clip 
function). Each of these techniques 
improves text display speed. 

PUTTING IT TOGETHER 

TEXTDEMO.PRG, on the START disk, 
demonstrates the use of most of GEM's 
text display features. It opens a wmdow 
and displays lines of text according to 
your specifications. With TEXTDEMO, 
you can easily display several lines of 
text with different attributes, since 
TEXTDEMO will not erase the window 



Character Attributes 



rw-\ 

I Cancel I 



Font i.d. (almays use 1 on ST) : 1 

Char. Height (Points or Pixels): 1Q 

Is "Character Height" in pixels? N 

Special Effects Flags (Decinal): B 

Foreground (Text) Color : 1 

Background (Line) Color : B 



This makes developing text applications 
on the ST a real challenge- — ^and tends 
to turn your life with GEM into a love/ 
hate relationship. 

At this point, let me recommend Tim 
Oren's article on GEM text — -column 
#10 — which may be found in the Pro- 
fessional GEM section in ANTIC OnLine 
on CompuServe. (Many Atari user 
groups have reprints of this article as 
well.) As Tim mentions, it is a good idea 
to start your text display on a byte 
boundary in memory (X-coordinate that 



until you give it an explicit "Erase Win- 
dow" command. 

To use TEXTDEMO, pull down 
the "Display" menu, and select "Char 
Attributes," The Character Attributes 
dialogue is shown in figure 1. The first 
field is the "Font i.d." (as in the vst_font 
VDl call). Changing the Font i.d. has no 
effect currently; this option is included 
for use after GDOS is released (see the 
"Bug Box" sidebar). 

Character Height may be specified 
in either pixels or points. Note that the 
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number of pixels applies only to the part 
of the cfiaracter above its baseline. 

The Special Effects value is the sum 
(in decimal) of the special effects bits 
you wish to be set. These bit values are: 
1 = bold, 2 = light, 4 = italic, 8 - 
underline, 16 — outline, and 32 = 
shadowed. Try various combinations- 
The effects of the Foreground and Back- 
ground Color values depend on your 
current resolution and color map, but 
is generally white, while 1 is generally 
black. You can get some very interesting 
effects on a color monitor! 



pixels relative to the display window's 
top left corner, and is the line's left base- 
line position. 

A single letter specifies Justification. 
Character justification adds space be- 
tween characters, while word justifica- 
tion adds space only between words. 

Horizontal Alignment is also spec- 
ified with a single letter, which deter- 
mines the horizontal "anchor point" for 
text display (left edge, centered, or right 
edge)- There is no visible difference be- 
tween the various horizontal alignments 
when justification is in effect. 



Line Attributes 



I Cancel I 



Text; Here is your text line. 



Display at (X-coardinate); 1G 

Display at (V-coordinate); 10 

Line Uidth (in pixels) : 306 

Line Height (in pixels) : 20 

Justification (None/Char/Uard/Both): B 

Horiz. Align. (Left/Center/Right) : L 

Uert (Floor/Desc/Base/Half/flsc/Top): B 

Baseline Rotation (degrees "^10): Q 



After clicking on the OK button, 
select "Display Line" from the 
Display menu. (For conven- 
ience, pressing any key on the keyboard 
is equivalent to selecting "Display Line".) 

The Line Attributes dialogue (figure 
2) allows you to specify a line of text to 
display (up to 30 characters), and its 
positioning and alignment. Position is in 



Vertical Alignment determines the 
position of each character relative to the 
specified Y-coordinate. That coordinate 
will fall on the top line, ascent line, half 
line, base line, descent line, or bottom 
line of the character cell. Since "Bottom" 
and "Base" begin vi'ith the same letter, 
we use "F" (Floor) for bottom alignment. 
The results of changing vertical align- 



ment value will probably surprise you; 
specifying "Floor" moves text up with 
respect to the drawn "Baseline," while 
specifying "Top" moves the text down. 

Finally, the Baseline Rotation value 
specifies a vector along which to display 
the text's baseline, Fven though this is 
specified in tenths of a degree (0 is nor- 
mal, 900 is straight up, etc), there are 
only four meaningful ranges on the 
ST screen — normal, backward, up, 
and down. 

Accepting the line attribute dialogue 
(pressing [Return] or clicking on "OK") 
displays the text line. If you are just 
changing character attributes, and want 
an immediate display, an easy trick is 
to press any keyboard key, then press 
[Return]; this brings up the line attri- 
bute dialogue, then accepts it without 
changing any line attribute values. 

TEXTDEMO draws a rectangle 
around your nominal text line in color 2, 
and draws a dotted line along the base- 
line in color 3 (both are black on the 
monochrome monitor). If you are using 
baseline alignment, the text will be ver- 
tically centered in the line rectangle. 

If your text window becomes too 
cluttered, you can use "Erase Window" 
at any time. "Quit" in the Exit menu re- 
turns you to the GEM desktop (or your 
shell). There are several ways to crash 
the system by specifying unusual com- 
binations of the dialogue parameters. 
This is intentional — it allows you to 
find out in advance where GEM is 
most likely to choke on your own text 
applications, 

HOW IT WORKS 

You should be able to learn quite a 
bit about how the various GEM text 
functions interact by first trying several 
minor variations of character and line at- 
tributes and then displaying the result- 
ing strings above or next to each other. 
Start by experimenting with the pro- 
gram in this fashion, before spending 
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significani: cime with :he code and 
"how it's done-" The source code for 
TEXTDEMO.PRG is in several files— 
TEXTDEMO.C and TEXTDEMO.H con- 
tain the main code, while DEBUG. C 
contains procedures for formatting nu- 
meric strings (used in TEXTDEMO's di- 
alogue-handling routines). In addition, 
TXDEMQRSC, TXDEMO.DEF, and 
TXDEMO.H contam TEXTDEMO's re- 
sources (the menu and dialogue boxes). 
DEBUG.C is generic — you can use it to 
debug your own GEM applications. 

The general flow of control in 
TEXTDEMO is similar to that of Digital 
Research's "doodle/demo" application, 
from which several pieces were bor- 
rowed. TEXTDEMO begins (in gemlnit) 
by initializing the desktop and opening a 
single window which completely fills the 
desktop's work area. The initial text line 
is set to fill most of the window's width, 
and to be vertically centered in it. The 
initialization routine also allocates and 
clears a buffer large enough to cover the 
entire screen. This is the "save buffer," 
and lets TEXTDEMO easily redraw the 
text window after it has been covered 
(as by the attribute dialogues). 

After initialization, control 
passes to mainLoop, which 
consists entirely of an evnt 
_multi in a loop. The evnt_multi looks 
only for messages and keyboard events 
(treating any of the latter as equivalent 
to selecting the "Display Line" menu 
item). The only messages considered are 
"menu item selected" and "redraw" (the 
latter happens on beginning the pro- 
gram, and whenever a window leaves 
the desktop, as after a dialogue is dis- 
played). Redraw is accomplished by 
copying the save buffer back into the 
text window. 

Selecting the "Char Attributes" menu 
item invokes charDial. This procedure 
initializes the fields of the Character At- 
tribute dialogue, then calls OEM's form 



handler, and finally (if the dialogue was 
not cancelled) stores the user-entered 
values back into the global textLine 
structure. The initialization and saves 
are performed by initChDial and 
saveChDial, Four general -purpose 
procedure set and retrieve values from 
the dialogue fields: getName, getNum, 
setName, and setNum, You may find 
this approach useful for editing complex 
dialogues in other applications. The save 
routine also uses a simple "character de- 
coder" (decodeO) to convert an entered 
character into the corresponding nu- 
meric value — this is easy, since GEM's 
attributes are all set with consecutive 
low numbers. 

lineDial, invoked when a key is 
pressed, or when the "Display Line" 
menu item is chosen, is only slightly 
more complicated, lineDial uses the 
same approach as charDial to initialize 
and read the dialogue. When the di- 
alogue is OK'd, lineDial restores the 
window — this is unnecessary for the 
other dialogues, since dismissing them 
causes GEM to issue a Redraw message 
to the application. Here, however, we 
want to display another line, then save 
the modified work area, which means 
we need to clean out the window first. 

As is typical in GEM (and in other 
graphics-oriented environments), some- 
thing like 90 percent of our code is de- 
voted to handling the user interface. We 
finally come to the application's heart 
in drawLine. This routine looks up 
the values stored in the global textLine 
structure, and attempts to display a line 
of text based on them. 

As mentioned, it is faster for an ap- 
plication to do its own clipping when 
displaying text. This is only significant 
if the text will in fact be clipped, and 
drawing off the screen without clipping 
is likely to crash the system (or at least 
GEM), so we ignore that advice and clip 
to the text window. 

We then call textStyle, which calls 



GEM's attribute functions with the spec- 
ified character and line attributes. This 
"environment" approach for defining 
display attributes may seem odd if 
you have used systems in which the at- 
tributes are specified in the display call. 
That approach is unusable in GEM, since 
there are so many different attributes, 
GEM's technique also lets you set the 
attributes once, then use them several 
times (as in displaying several lines of 
text with common attributes). 

Pay close attention to the verbose 
comment about vst_height, in the 
texlStyle procedure — the correct values 
for the default system font sizes are 
probably not what you expect them to 
be; size is specified in height above 
baseline, not total character cell height, 

JUSTIFIED TEXT 

Displaying justified text under GEM 
is trivial — you simply call v_justified 
instead of v_gtext- It wasn't all that long 
ago that displaying or printing justified 
text was one of programmer's more ^ 
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SI ART is a magazine with its pro- 
grams on disk. Normally you will find 
the disk bound into the magazine and 
for sale on the newsstands at a com- 
bined price of $14,95, 

But we know that some of you ST en- 
thusiasts want to read SJart first, with- 
out paying $14,95, so we have provided 
a limited number of copies without disk 
for $4.00 each. 

If this is your situation, you can com- 
plete your copy of this collector's issue of 
START by ordering the companion disk 
direct from us, for $10,95 plus $2.00 
shipping and handling. See the handy 
order form 
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cumbersome tasks. 01" course, you still 
need to put reasonable amounts of text 
on each line, so that the spaces aren't 
too large or too small (line-breaking is a 
subject deserving its own article). 

You will find the problems with 
GEM's justification feature (and with any 
display involving proportionally spaced 
characters) when you try to mix char- 
acter styles in a line, or if your text is 
user-editable. Since you must specify X 
and Y coordinates for each text display 
operation, you need to determine where 
to start each "piece" of the text line 
(when mixing styles). 

When using a monospace font and 
not justifying, this is easy: determine the 
character width in each style, and multi- 
ply by the number of characters dis- 
played. To get the width of each sub- 
string, increment the X-coordinate by 
this amount each time. 

The task is just a little harder with 
non-justified proportional type. GEM 
provides the vqt_extent call, which re- 
turns a box describing the exact size of 
a string in a given style. Use this to find 
the width of each sub-string, and incre- 
ment as above (but see the Bug Box if 
your string is italic). 

justifying text makes things much 
tougher — where the substrings will go 
depends on how many spaces there are 
in each of them, as well as on the nomi- 
nal string widths. Your best bet is to 
avoid the situation. If you can't, you have 
to pre-scan the string, counting spaces 
and characters- of-width, etc. 

Much of GEM is based on the Small- 
Talk model for user interface. SmallTalk 
recommends a single procedure, 
"scanLine-" With several functions — 
depending on a flag, it will display a 
string, measure the string's width (in- 
cluding the effects of justification on it), 
find the X-offset corresponding to a 
given index within the string, or return 
the index of the character closest to a 
specified X-offset- 
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Alignment: The relative positioning 
of text, compared to fhe coordi- 
nates specified in a vq_text or 
v_justified VDI ca//. The most com- 
monly used vertical alignments are 
"baseline" (recommended if you 
plan to mix fonts, since ttie base- 
lines of all text on a given line must 
be the same) and "top". You are 
familiar witli top alignment from 
non-graphics text; it simplifies the 
issue of determining clipping and 
erasure boundaries, fdorizonial 
alignment determines whether the 
text will be displayed to the right of, 
centered on, or to the left of, your 
specified position. Both horizontal 
and vertical alignment are set using 
the vst^alignment call (VDI opcode 
#39). 

Alpha Text: A GEM term for the text 
normally used by a computer sys- 
tem (what non- GEM applications 
would display, the system font). 

Baseline: An imaginary line on 
which the capital letters in a line of 
text rest When mixing type fonts 
on a line, the rule is to use the 
some baseline for all of the fonts. 

BitBit: Bit Block Transfer, a term bor- 
rowed from SmallTalk, refers to the 
copying of a rectangular block of 
pixels (screen bit locations) from 
one place to another, possibly per- 
forming a transformation on the 
way. In GEM, characters are dis- 
played by copying a bit image of 
the character from memory to the 
screen, a process made possible by 
the the speed of the 68000 chip. 

Cell Width and Height: In GEM, 
the size of a rectangle of sufficient 
size to display a given character 



with an appropriate amount of 
white space on all sides. In a 
monospace font, oil characters 
have identical cell width and height. 

Font (or Typefont): A set of charac- 
ters having the same genera! ap- 
pearance, style, and size. The 8x8 
screen fonf on fhe color ST monitor 
is an example; the italic version of 
this screen font Is another "font" 

GDOS: The "Graphics Device Op- 
erating System." GDOS is a portion 
of GEM which allows GEM to deal 
with certain device-dependent 
features, such as multiple "work- 
stations" (screen and printer, for 
instance), and multiple type fonts. 
GDOS was not released with the 
initial RAM or ROM versions of 
TOS, but should be available 
shortly. It is an overlay to the main 
part of GEM, and so can be pro- 
vided after the fact (i.e. GDOS 
would not have been part of the 
ROM code in any case). Until 
GDOS is released, many functions 
of GEM are unavailable (see the 
"Bug Box" sidebar). 

Graphics Text: A GEM term for text 
displayed within GEM by plotting 
individual characters as graphics 
images (see BitBlf). 

Justification: Adjusting character 
and/or word spacing in a line to 
make the string fit a specified 
width. The term is also used ("Left- 
Justified," "Center- Justified," etc.) to 
refer to horizontal alignment (see 
Alignment). 

Leading: -Amount of space between 
lines (distance from the baseline of 
one line to the baseline of the next). 
A good rule of thumb is to use op- 
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proximately 20 percent extra lead 


the "W"). Nearly all books, maga- 


with proportional space type; 10 


zines, and newspapers use propor- 


Fbint type looks best with 12 Points 


tionally spaced type — it uses much 


total line leading. TEXTDEMO.PRG 


less (30 percent-50 percent) space. 


refers to (Y as "Line Height" to 


reads quickly and is visually more 


avoid confusion. 


pleasing. GEM provides support for 


Monospace Typefont: A fypefont 


proportional fonts, but these fea- 


in which all characters have the 


tures ore incomplete on the ST at 


same width. All of the standard 


this time. 


ST screen fonts are monospaced. 


Raster vs. NDC Coordinates: 


Monospaced characters are easily 


GEM allows positions to be spec- 


manipulated from a computer 


ified either in terms of absolute 


program, since no special width 


screen locations (Raster Coordi- 


calculations need be mode. 


nates) or relative locations in terms 




of an idealized screen (Normalized 


monospace fonts. Pitch is the num- 


Device Coordinates, or NDQ. 


ber of characters which fit in an 


Since typefonts are available only 


inch, horizontally (Elite type is 12 


in certain pre-specified sizes, any 


Pitch, or 12 characters per inch, 


program that needs to use text is 


while Pica type is 10 characters per 


well advised to stick with Roster 


inch). Note that GEM never deals 


Coordinates, which are signifi- 


with pitch — monospace choracfer 


cantly faster than Normalized 


sizes are instead set by character 


Coordinates. 


height above the baseline, in pixels! 


Style: A generic term for the attri- 


Point Size: The most common way 


butes of a text character. These in- 


of specifying the size of propor- 


clude the character's type family. 


tional space fonts. A poinf is 0.0138 


and "special effects" such as bold, 


inch. All characters in a font are 


italics, underlining, etc. Modest use 


nominally guaranteed to fit in an 


of special effects enhances fexf 


oreo with a height equal to the 


readability and appearance. 


point size. Thus, consecutive lines 


Typeface: Collection of all sup- 


will not overlap if the leading is at 


ported sizes of a given font, but 


least equal to the point size. GEM 


staying with a single style. 


allows programs to specify Point 


Type Family: A co//ecfron of related 


Size in full points (half-points would 


typefaces. Popular type families in- 


be better), and will display with the 


clude hielvefica and Times Roman. 


font most closely matching the 


The entire collection of mono- 


specified point size. 


spaced screen fonts for the various 


Proportionally Spaced Typefont: 


ST resolutions could also be said to 


A typefont in which different char- 


comprise a "family" of type. 


acters may have different widths 




(for instance, the letter "i" will prob- 




ably be significantly narrower than 





Why put all that utility in a single 
routine? There are many ways to justify 
text or to display certain sequences — 
kerning, ligatures, and so on. (Editor's 
note; for a better treatment of tfiese ad- 
vanced topics, see resources listed at end 
of article.) The same algorithms must 
he used for any of the four operations 
mentioned, since inconsistent sizes 
or positions could otherwise result. 
Unfortunately, GEM does not provide 
such a scanning routine. 

This means there is no straight- 
forward way to accomplish mouse-ori- 
ented editing in justified or proportional 
text. You can try to second-guess GEM's 
justification algorithm (and hope that it 
will be consistent on other GEM sys- 
tems to which you later port your ap- 
plication), and "scan" accordingly, or you 
will have to do your own justification. 
Once again, your best bet is to not allow 
direct editing of justified or proportional 
text — if you can survive without it. 

ITALIC CHARACTERS 

Using italic characters under GEM also 
appears to be quite simple — initially. 
Simply call vst^effects, specifying the 
"Skewed" special effect, then do either a 
vq_text or a v_justified call to display 
the text. If your entire string is italic, 
this will work fine, as long as you leave 
a little extra room on the string's right. 
The bad news comes when you mix 
italic and non-italic characters. It seems 
that skewed characters in GEM really 
are skewed- — GEM displays them ap- 
proximately half a character position to 
the right of where they should go! This 
means that, if you are using Replace 
Mode (recommended for smooth dis- 
play), the next non-skewed character 
you display will erase the right edge of 
the last skewed character. (If you have 
1ST Word, you will be able to demon- 
strate this phenomenon. Type "GEM" in 
italics, followed immediately by a non- 
italic space.) In addition, unless you take 
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THE 
BUG 
BOX 



Yes, GEM does have a jew bugs, Uere are 
several specijicaWy related to text han- 
dling. STAKI welcomes comments, addi- 
tions, and^espedaWy—jixes. 



7 Italic characters are offset from their 
ideal "cell" location, so the right 
halves of characters are clipped when 
italic characters abut non-italic 
characters. 

2 The vqt_extent VDl call (opcode 
116) returns an incorrect value 
(much too large) for italic text. 

3GD0S is not included with JOS. 
Therefore, only the monospaced sys- 
tem fonts are available. (VDl opcode 
#119, vst_load_fonts, will crash the 
system. So will attempting to open a 
workstation other than the screen, sued 
as a printer.) Application packages using 
GDOS are beginning to appear on the 
market, and Atari is evaluating a version 
of GDOS for release. 

4 There is no "scan" function corres- 
ponding to justified graphics text 
display", making v_justified (opcode 
#11-10) useless for text editing applica- 
tions (sec article). 



5 The v_justified call produces 
strange (and apparently' unpredict- 
able) results when both the word-spacing 
and character-spacing flags are False 
(no justification desired). This case 
should be the same as using v_gtext, but 
is not. Use v_gtext for non-justified text. 

6 The rightmost pixel of bold charac- 
ters (when using any of the s^'stem 
fonts) is clipped. This is not. strictly 
speaking, a bug— it is a 'feature" which 
ensures that the width of characters in the 
system font remains constant even if bold 
characters are used. 

7 Text display slows down significant!}' 
under some conditions, in particu- 
lar, characters which do not fall on an 
even eight-pixel boundary take much 
longer to display than those which do, 
and text display becomes much slower if 
clipping is needed. Also, display of pro- 
portionally-spaced characters using ver- 
sion 1.2 of GEM on the IBM PC is in- 
credibly slow; we can hope that the 
GDOS Atari releases will be /aster (the 
"Blitter" chip can also he expected to 
improve all of the speed problems 
signficantly). 

8 GEM allows text to be rotated in 
tenths of a degree, but does not sup- 
port fractional point sizesi (Rotations 
other than at 45 degree angles are rare. 
whereas certain half-point si^es, such as 
5.5 Point type, are quite convnon.) 



special precautions (as 1ST Word docs), 
you may end up with "mouse droppings" 
(eitra displayed pixels) at the beginning 
of the italic string. 

If this isn't enough, GEM also returns 
incorrect values if you do a vqt_extent 
(VDl #116) on an italic string- You have 
to get the width of a string of italic char- 
acters the hard way — call vqt_width 
(opcode 117) for each character, ignor- 
ing the left and right "alignment delta" 
values returned. 

There is no such easy work-around 
for the position problem; how well you 
solve it depends on how much work 
you're willing to do. The simplest "solu- 
tion" is not to mix italic and non-italic 
text at all. If you can get away with this, 
you probably don't even have to worry 
about the half-character positioning er- 
ror — no one will notice. 

CONCLUSION 

GEM has given us an excellent set of 
tools for displaying clear and "interest- 
ing" text. Although these tools contain a 
number of bugs and "blind spots," with 
a little care they can be used to greatly 
enhance the appearance of ST screen 
text. Using GEM for leverage, you can 
write text-oriented programs with much 
more sophistication, and in significantly 
less time, than on non-GEM systems. 
Use GEM's text features — your applica- 
tion and its users will benefit! ■ 

REFERENCE: 

• Phototypography: A Guide to Typeset- 
ting and Design, by Allan Haley, 
Charles Scribner's Sons, 

New York, NY 

• Publication Design, Second Edition, 
by Roy Paul Nelson, Wm. Brown 
Company Publishers, Dubuque, lA 

• Smalltalle-SO," The Language and its 
Implementation, by Adele Goldberg 
and David Robsen, Addison -Wesley 
Publishing Company, Menlo Park, CA 
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ST CALC 



PUT ST CALC'' TO WORK 
FOR YOU AND BENEFIT 
FROM THE RESULTS 



ST CALC™ !s a fully implemenled GEM^''^ 
based spreadsheet for home and business 
use, This IS by far the most powerlul 
spreadsheet available for the price. Better 
yet, all commands are mouse controlled 
for speed and ease of use. ST CALC'^''^ 
also uses lass memory than other spread- 
sheets for the ST, leaving more room for 
your data and formulas. II you've never 
used a spreadsheel before, you'll be 
amazed how easy ST CALC^" is to learn 
and use. The experienced user will love 
the speed of a mouse controlled spread- 
sheet. 




CH rai 

FIIRHIIIIBE 
CLOIHUG 



ONLY $49.95 

FEATURES 

^ 50 columns by 999 rows 

,^ Extensive use of GEM^'^ windows 

^ All commands are under mouse 

control 
^ Built in 10 keypad calculator 
c On-line tielp windows (No commands 

to memorize) 
^ Built in sort routine 
(^ Developed exclusively for the Atari ST 
^ 10 macros controlled by tfie function 

keys 
^ Split-screen capabilities 
i^ Note Pad 



MOUSE CONTROL 

Extensive use of tfie GEM^'"' windows 
make ST CALC^" a fast, extremely easy- 
to- use spreadsfieet. With over 50 
commands available from the mouse, 
the ease of use is unsurpassed. Imagine 
being able to move or copy an entire 
column of figures with a simple mouse 
control. 



CALCULATOR 

ST CALC^'^ includes an easy to use 10 
key calculator that can be pulled down 
at anytime and operated either by 
mouse or keyboard. With the point of a 
mouse, the results of the calculation can 
then be transferred to the cell of your 
choice. 



NOTE PAD 

ST CALC^'^ lets you attach a personal 
note of up to 4 lines to any cell. The cell 
is then highlighted to remind you there 
is a note attached. For example, you 
could attach a note to the insurance cell 
of your personal finance spreadsheet 
reminding you that the cell applied only 
to car and home insurance. The note pad 
can be pulled down at any time. 



HelpCalcST omy 24.95 

• 11 preprogrammed templates tor use 

with ST CALC™ 0, VIP Professional™ 
" ioad-and-go and these templates will 

take the work out of tedious 

spreadsheet setup, 

emplates include: 

Check Register 



It Portfolio 



Analysi! 
ctory 



Home Invenlofy 
Loan Amortizalion Schedules 
Personal Finance SlatemenI 
and more VIP PROFESSIONAL 

VIP TECHNOLOGIES. 




ST STAND 




ONLY $29.95 

, $5.00 Min. Shipping S Handiing 

Custom made just for Itie ST, beaut 
Imistied stand to tiold your ST monitor. 2 



IF YOU DON T HAVE OUR CATALOG . 
. . .YOU'RE MISSING OUT ! ! I 




DELUXE DUST COVERS 

Deluxe Leather Gram (^r^;zzr_i^!:x 

PF10TECT YOUR INVESTMENT £tl!3^~^^^^^^^^^^ii-^^ 

Cusloii fpllefl. atlraclive leather Drown color 



• COMPUIEHS— lOOiflOO 600/8DO.' UOOXL 65.'130XE 

• DISK OniKES— ASIHfl 1620 AIARI 1D5D ST DRIVES 
St HARD DRIVE INDUE GT PERTOM 88S1'flBSPD RANA 
IRAK > PHINTEHS— ATARI 1025/t027 AXIOM SLP/GLP 
QKIMATE 10 ■ RECORDER— ATARI JtD * WOPEM^TAH 

• COMPUTER— ATARI 520;IW0St • PRINTERS— ATARI «. 
AXIOM MO CITOH/PROWRITER 8510 CPAflO/EPtiO 
EPSON MX/RX/IX/FXBO til & W/D TRACTOR fEED 
GEMINI/STAR SO 10 X PANASONIC 109in092 RITEMAN il 



HELPMATE ST oniy $39.95 

HELPMATE ST'''" INCLUDES: 

• Appointment calendar with alarm lunclions 



• Telephone 
All in one 


program 


ft 


i 




1 


EST 



The best pa't Is that HelpMate ST stays "hiOden" in 
memofy until needed, and then can be called uo loi 

down menus can be used with most ST prog'ams or by 



Coming Soon!! 

INVENTORY^ 
MASTER ST "'only $179.95 

INVENTORY MASTER ST^" Is a power- 
ful, Inventory control and Report genera- 
tion program. It will do more than just 
keep track business inventory, such as; 
detailed report generation, fast and easy 
data retrieval, versatile data entry, takes 
the work out of decision making, plus 
much more. 



COMPUTER 



OPEN M-T 9-6 Sal 10-4 (Pacilic Time) 
2160W lllhAvenue Eugene Oi 




USE YOUR CREDIT CARD S, CALL 

Toll Free 1-800-452-8013 
* ORDERS ONLY. PLEASE ♦ 

[***^^ rhere's never a penally ionising your credit cardi 
For Inlormation. Call (503) 583-53B1 
Prices subject to change without notice. 



I II Lallus jti5a3l6S3-S361 

Willi jimltier CDDl ol llif 5 line proqisni piheiwise no sot l 

. 2 Diy Air Shipping AVAILABLE • 



ComDutin 



The Pragmatic Art of Defensive Programming 



Kp SMALL 



Being a rational contemplation of the vagaries surround- 
ing computers, programming, and the precariousness of 
heavenly bodies and telephones in juxtaposition to 
floppy disks. Mr. Small expounds upon mayonnaise, 
cosmic rays and his personal, violent hatred of structured 
programming. 




ro the outsider, computers are clean, utterly rational and cut-and-dried. They appear 
to be the same machines I was taught about at college; numl^er crunchers governed 
by strict physical laws. 
When i graduated and entered the real world, I learned it just ain't so. And over the 
past ten years, since my initiation into Hackerdom, I have formulated a valuable 
principle, which I will share with you. 

But first, let us examine for a moment a typical computer, to get an idea how uncertain 
and fragile a medium it is, 

DIGITAL AMNESIA 

We'll begin with memory — a frighteningly transient thing. Most personal computers 
today use "dynamic RAMs," a Faustian bargain to pack a lot of memory into a small area. 
The "dynamic" means that if you don't access that memory at least 100 times a second, it 
will fade awav. 
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Now, you say, you've got to be kidding. One hundred times 
a second? That's pretty fast. But every computer v/orking today 
is actively struggling just to keep its marbles. Turn on an Atari 
8-bit computer; ji;st sitting there, displaying "Ready," it is con- 
tinually accessing and "refreshing" its memory 

Novv' let's talk about cosmic rays. Cosmic rays have a truly 
witty effect on dynamic RAMs. They make memory cells flip 
randomly. 

Used to be, with the older RAMs, memory wasn't so sen- 
sitive. Not anymore. In Denver, a personal computer owner 
can reasonably expect one memory "soft hit," or failure, per 
week, during normal solar activity; this gets worse during so- 
lar flares. 

Dynamic RAM chips are also the most skittish and easily 
zapped chips known. They have a nasty habit of "ringing" and 
"undershooting," which means they generate negative voltages 
which they feed to other chips, destroying all the chips in- 
volved. Also, any brief, transient power "spike," (like youi' next 
door neighbor's washing machine turning on), can flip a few 
bits. 

Count on this: For every system crash caused by RAM 
failure, there are ten unseen events where RAM bits get 
flipped- They just happen to get flipped somewhere where it 
doesn't matter at the moment- 
Think of dynamic RAM as 65,536 dominoes stacked on 
top of each other. One small push, and down they go. 

And then, there are diskettes. 

TRUST NOTHING 

Data is stored on diskettes with tiny, tiny, tiny magnetic fields, 
which are both remarkably durable and very sensitive. For in- 
stance, my daughter Jennifer once smeared mayonnaise across 
a 3 1/2-inch diskette (opening the little sliding door to do it, 
too). The diskette survived. However, I once had a phone ring 
ne.xt to a diskette; the diskette was completely erased. (Now 1 
treat the phone as if ii: had the plague and keep it across the 
room.) 

And how about keyboards? When you press a key, you 
bring two contacts together. What you're not told is that those 
contacts bounce against each other before coming to a rest, 
something like dropping a bouncy rubber ball. Whenever the 
computer looks for a key, it must deliberately wait for awhile 
before looking for another key, because the first key is still rat- 
tling from being pressed. 

1 could go on about rise times, about marginal clocks, 
about how even trying to view a crystal with an oscilloscope 
will cause the crystal to quit working. But the end point re- 
mains the same; Computers are a very '"iffy" item. 

You are working in a medium that is lucky just to keep 
running, that often fails through no fault of your own. Add to 



this the fact that human beings are not perlect and computers 
demand perfection in their programming, and you get the ulti- 
mate question of the Frustrated Programmer: Is this problem 
in my program or in the computer? 

Something wonderful, childlike, and naive dies in a pro- 
grammer the first time a computer genuinely screws up. Up to 
thai point, you are .sure the problem is yours, somehow, some- 
where. Afterwards, you are never the same. It's like learning 
the truth about Santa. 

So what philosophy does a sane person adopt? 

Working with computers is like performing sorcery Treat 
programming as you would treat casting spells. You'll go far. 

Just as sorcerers drew pentagrams to control and bind the 
demons they summoned, 1 find I must adopt certain defensive 
measures to prevent computers from causing a lot of trouble. 
My philosophy is contained in ten maxims. 

MAXm NUMBER ONE: 

When you're having a bad day, stop working. 

Every programmer has had days like this. Compilers mys- 
teriously quit working. Disks stop loading. The hard disk 
flakes out. Nothing works right. You sit and think of alternate 
approaches, try them, and find your way blocked. The next 
day, of course, everything works right. 

rhe thing to do here Is to quit. Consider yourself bad luck 
that day. Anything you Couch is going to fall. Remember those 
cosmic rays massaging your memory chips. 

So lock your backup disks in a vault, and go du something 
useless, like creating a structured design for your next 
program, 

MAXIM NUMBER TWO: 

Comment your code to death. 

Dark Ages spellcasters wrote down every detail of their 
spellcasting in their spellbooks, or "grimoires," because they 
wanted to be able to retrace their steps in case of failure. Ac- 
cept that your memory is not perfect. You will probably have 
to return to your code one day and fix it, or use it in another 
program. So comment it, k only takes a minute more, and it 
pays for itself many times over. 

MAXIM NUMBER THREE: 

"Programming is an art best learned by apprenticing to a mas- 
ter." Or "Steal from the best," (Quote attributed to Russell 
Smith.) 

Medieval sorcerers had no problem with borrowing each 
other's spells. Working out a spell, and keeping the demons 
from snatching you away to the inferno, was no easy task, 
right up there with debugging assembly language. Once you 
got something working right, it was most valuable. ► 
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Good programmers, che true Hacker brechren. know this 
instinccively. This is why they are usually happy to share code. 
And looking at someone else's code is often the only way to 
pick up clever tricks. 

Chris Crawford taught me all about ensuring that the deci- 
mal flag is cleared before doing interrupt processing; other- 
wise, arithmetic you do on the 6502 during interrupts can 
m)'steriousIy go bad, unpredictably and untraceably 

John Harris found sections of his sound generation code 
(from "Frogger") being used in other games. Rather than being 
insulted, he understood the implied compliment: His code was 
worth copying. 

So, let other people look at your code. Don't be embar- 
rassed; asking for comments is the sincerest way to flatter 
someone. 

Find out who )'our local hackers are and join their group. 
Hackers are basically people who believe in freedom of infor- 
mation exchange. If you become part of the loose, informal 
hacker group around you, you will have access to code, tools, 
and amazingly crcati\'e people. 

MAXIM NUMBER FOUR: 

Use the best tools, and be willing to pay for them as neces- 
sary. Your lime is valuable, and it is a pleasure lo use good 
tools. 

Use quality assemblers, compilers, interpreters. The time 
spent tracking down just one bug in your tools is worth the 
cost of using good tools to begin with. After all, you wouldn't 
expect sorcerers to skimp on the quality of newt eyeballs if 
they thought their spells might backfire. 

Use/as( tools. You'll be assembling, compiling and inter- 
preting many times on any project. Even saving a few seconds 
per assembly is worth it. This also makes hard disks and 
RAMdisks worthwhile. The time you save is your own; noth- 
ing is more stultifying to the senses than watching a computer 
do something for the eightieth time. 

Fast tools include a fast printer You need to make lots of 
printouts as part of che game. If you stick with something that 
prints slowly, you'll be waiting a long time before you can 
make progress. 

On my most recent project, making an Atari ST think it 
was a Macintosh, the program ended up being 7000 lines long 
(which ought to tell you something about how loosely my 
head is screwed on; it's all assembly language, too). Anyway, 
the printout is 120 pages long and takes awhile to print. Not a 
good job for a slow printer. 

The time you save pays for itself. Your work gets done 
faster, which in the case of a freelancer, means you are avail- 
able for other work. 



MAXIM NUMBER FIVE: 

Keep a copy of everything you do — disks and printouts. Put it 
somewhere, file it away, but keep it. You will always come back 
to it. 

Corollary; Reformat a disk you will "never use again" and 
you'll need it tomorrow. 

Among the very few bright things 1 did at college was to 
keep most of the programs I wrote, just one extra printout. It 
only took a minute back then. And now I have a library of de- 
bugged routines and software. 

This is especially important to freelancers. You haven't time 
to redevelop che wheel, and ic is impossible co remember eve- 
rything about a project you did awhile back. But if you have a 
printout of, for instance, how to set up a player-missile table, 
and better yet, if you can import that code off an old diskette 
directly into the editor, you've saved a lot of time. 

Remember the John Harris syndrome: He kept all his 
floppy diskettes, including the master to che superb "Frogger," 
in one nocebook. Once, he wenc to a computer show and dem- 
onstrated that disk. Someone stole the notebook and he lost all 
his disks and an incredible amount of development time. This 
is the real story of why a pirated Frogger showed up a year be- 
fore the real Frogger; John was busy rewriting all his old code. 

MAXIM NUMBER SIX: 

Backup your backups. Keep three of everything. 

Computers typically fail as you back up the master of your 
program. This takes out not only che master, but the backup, 
since both are in the computer at the same Cime. 

The solution is a third diskette. Just write a copy of your 
current program out to it every so often, then take it out and 
file it. 

Don't be hasty to use your backups. Whatever killed your 
master disk might take the backup, too. Make sure youVe 
fixed the problem. Test first. 

Recently, I had che charming experience of trashing an 
Atari ST hard disk, I closed the current direccory, and opened 
up the backup disk to repair the hard disk. The backup's 
direccory prompcly and permanently disappeared, leaving 
me the fun job of retyping che whole program I had been 
working on, 

MAXIM NUMBER SEVEN: 

Frame chis; hang it over your desk: Don't be clever. 

There are so many clever Cricks to use in a computer, and 
so little reason to use them. Unless you really need the speed 
and code size of a clever hack, avoid it. There are always side 
effects. 
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Some sorcerers used Latin and took other steps to make 
their spells unintelligible. They used Iocs of incense (which re- 
minds me of structured programming: It makes your eyes 
hurt, and confuses the whole ceremony, but does make you 
feel you have accomplished something). 

Avoid Utterly Clever Constructs, The worst offender in this 
department is C. which 1 have to come to see as an abbrevia- 
tion for "Clever," C is a wonderful language to write code to 
show off with; "Gee, Fred, I never thought of doing it that 
way." 

Fortunately, it is possible to write legible C code, chat actu- 
ally can be understood when reread, (This is contrasted to 
APL, a language once accurately described as "Write Only",) 

Anyway, odds are, in a month, you'll forget just how chat 
witty piece of code works, so why go to all the bother? 

MAXIM NUMBER EIGHT: 

If it works, don't fix it. 

The computer doesn't care how it looks. So it's a kludge? 
An utter pile of Crash? So what? If it works, leave it alone and 
do something else. 

Skip the indenting of your code; don't sweat the trailing 
comments and "pretty printing" Don't be a neat-freak, neat- 
freaks accomplish little. Leave it and go do something else. 
You owe it to yourself. 

Consider code development as you would consider crossing 
an unstable, dangerous bridge. Sure, maybe you have to do it 
once. But who wants to do it twice? Look at Chris Crawford's 
Eastern Front code. There are sections that are not clean, ele- 
gant, or structured. It works. Ic is art. Who cares what the 
code looks like? 

MAXIM NUMBER NINE: 

Always give your code the maximum chance to work. Or: It'll 
always chink of something you don't. 

When summoning demons in che old days, you wrote de- 
tailed contracts specifying exact terms of employment and 
payment. You tried to think of every condition — because de- 
mons were notorious for wriggling through loopholes. Really 
smart sorcerers added a "catch all" to the contract to cover 
what they didn't chink of. 

Do che same. Wrice defensive code. 

Using a variable? Inicialize it just before you use it. Don't de- 
pend on ics value staying che same from che start of the pro- 
gram; you might use it for something else, or, (horrors!) the 
memory location ic occupies might get clobbered accidentally 

Don't end a loop just by checking for a value equalling an- 
other value. Check for greater than or equal, or less than or 
equal; you might miss che equaled value. Give your program a 



chance to recover gracelully. 

MAXIM NUMBER TEN: 

Structured programming is useless in che real world. 

You don'c need co program in a structured way Give your- 
self some credit. You're neither a moron nor a menace Co soci- 
ety. Don'c use a language that forces structure on you. 

Corollary: If a GOTO statement is so terrible, how come 
every microprocessor has one? And uses it frequently? 

Pascal, to quoce Chris Crawford, is the fascism of compucer 
languages. And Pascal is The Great Language of Structured 
Programming. You can only do things one way — and there's a 
lot of mindless quibbling you have to go through to get ic 
done. 

Pascal also produces notably inefficient code, for the simple 
reason that computers don't use scruccured code, people do. 
Putcing it mildly, something is lost in the translation. Personal 
computers are not yet at the point where you can afford to 
throw away a great deal of processor time letting the computer 
trundle through your "structure." 

it is fine to draw up a general idea of what you're gomg to 
do, but carry it too far, and it's like working inside a strait- 
jacket. You cannot think of everything at once, and that in- 
cludes the structure of your program. Try to lay everything out 
in the beginning and you will throw out all the perfectly good 
ideas which occur during the coding process. 

So use an anarchist's language such as C and obey jusc 
enough rules to get by. Don't cake any extreme position, be it 
writing a thousand lines of uncommented assembler or pre- 
structuring your program. Remember, there are enough things 
working against you that you muse recain maximum flexibility 
to get things done. 

CONCIUSION 

Thus ends my Pragmatic Programmer's Philosophy Bui I have 
more ideas. Many more. Should I be given the opportunity to 
speak again, I could tell you about Avoiding Burnouc: The Ca- 
reer Programmer's Plight, or Fooling the Boss wich Massive 
Printout. If the START editors will only lee me. 

(Editor's note: Perspectives is ajorumjor commentary on 
the programmer's art by its diverse practitioners. START wel- 
comes reader response to the ideas and opinions expressed in llijs 
department.) ■ 
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Al 

andC 
Routines . . . 



Fast Memory Manipulations and More 



BY DAN MATEJKA 

These two AL routines, plus a full, C "Help" text window 
module Miill speed your programs and make them more 
professional. Both AL routines — very fast implementa- 
tioYK of a standard memory move and memory initializa- 
tion — are accessed as functions from your main C pro- 
gram. The C text window module provides a 
standardized method of displaying text to screen or 
printer with auto-word-wrap. All programs may he 
found on the START disk within the folder labelled 
ROUTINES. 



I M When Stanley Crane and I were writing DB Master One, the database bundled 
IfflV with the ST last Christmas, we found frequent need for wholesale memory 
■ m moves and initializations. DB Master One Is a RAM-based system which loads 
the entire file from disk once each session, does its work all in memory, then writes it ail 
back to disk. Necessary — but boring — operations like memory moves should be 
completed as quickly as possible. Straight C wasn't speedy enough, so we wrote the code 
ourselves to handle these situations. 
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In developing Disk Doctor for Antic publishing, I needed a 
friendly method of displaying "help" information on the 
screen. Since this would be a useful — and reusable— routine, 
I wrote a stand-alone C module for the purpose. 

This article describes two assembly language routines — ac- 
cessed as linked C functions-^ which provide a fast block 
memory move and an equally fast memory initialization. Fol- 
lowing this is an analysis and description of the C printout 
module, PRINTOUT, which reads standard text files from disk 
and displays them CO either screen or printer, left-justified and 
with word wrap. PRINTOUT will also provide an example of 
practical usage of the two AL routines. 

MEMORY ALTERATIONS, WHILE YOU WAIT 

The two memory operations we're going to talk about are 
setmemC) and movmemC). They can be found as 68000 as- 
sembly language source code in the file MEMOPS-S, on your 
START disk. 

setmemO initiahzes memory to a chosen byte and 
movmemO grabs memory and copies it to some other loca- 
tion. Our version of these two functions is five times faster 
than their Alcyon C counterparts. This can make all the differ- 
ence in the world to the person sitting in front of the terminal 
watching, for example, a scrolling screen. Screen scrolling is 
most painlessly accomplished by grabbing memory corres- 
ponding to each line of interest and putting it somewhere else. 

Both functions were designed to be called from a C host — 
specifically a C host compiled by Digital Research's C compiler 
(the Alcyon compiler included in the developer's toolkit from 
Atari), This compiler allows unrestricted use of registers aO-a2 
and dO-d2 within any procedure, movmem(} and setmemO 
use no other registers, so no registers are pushed onto the 
stack for later retrieval. This compiler also uses two-byte inte- 
gers, Pascal programmers will note the parameters are not 
cleaned off the stack at procedure's end, either. 

If you are tising the Alcyon compiler, all you need do to use 
these procedures is assemble the included file and link it with 
its host. Other compilers will doubtless have different linking 
and register usage conventions. 

The complete C protocol for using these procedures is: 

movmem( source, destination, count) 
char * source,* destination; 
int count; 

setmem(destination,count,vaIue) 
char *destination; 
int count, value; 

For movmemC), count bytes are moved from source to 



destination. For setmemO, count repetitions of value are 
placed at destination. Note that value is a byte, not a word, 
value. For example, given a declaration like: 

char stuffllOOj; 

the call setmem(stuff,sizeof(srufO,'a') sets every element of 
stuff to 'a's. The call movmem(&stuff[10],&stuff[6],20) 

takes elements 10 through 29 of stuff and copies them to ele- 
ments 6 through 25. 

More or less equivalent C source code looks like this: 

/* initialize memory '*/ 
setmem(d,c,v) 

register char ■*d; 

register int c,v; { 

while (c~) 
*d-(- -I- = v; 
} /* end setmem '*/ 

/* move memory around */ 
movmem(s,d,c) 

register char *s,*d; 

register int c; { 

if (s > d) 
while (c--) 

*d-l- -I- = *s++; 

else { 
s -I- = c; 
d += c; 
while (c— ) 

*..d; = *-s; 

} 
} /'* end movmem */ 

Note that bad things happen if you send a negative value 
for count. 

setmemO is straightforward. Starting where it's told, it 
marches through memory, setting each consecutive location to 
the value it's told to use, until k's told to stop. 

movmemO works similarly, but a twist is encountered if 
the source and destination areas overlap. For example, given 
the following call, in which we move from a low address to a 
high address: 

movmemC &stuff[6], &stuff[10], 20 ) 

If you start with stuff[6], by the time you get to stuff[lO] it 
has already been polluted by stuff[6]. Effectively, you will 
have copied the first four bytes five times. ► 
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To a\'oid this problem, when working with overlapping 
memor)', you must manipulate the memory elements in re- 
verse order of the move. In the above example, start with 
stuff[25] and finish with stuff[6], movmem() is smart 
enough to handle this for you, so you do not have to think 
about it. 

CLOCKING IT 

Some time spent with the actual machine instructions gener- 
ated from the above C code quickly shows the speed advan- 
tage of assembly language. The heart of the movmem() 
procedure, 

while (c— ) 

*d+ + = *s+ +; 

is complied by DRTs package into assembly code which looks 
like this: 



* (line 7) - 


a5 is s, a4 


is d, d7 is c 




moveloop: 


mnve,b 


(a5} + ,(a4) + 


* *d++ = 




move 


d7,dO 


* copy count 




suh,w 


#l,d7 


* decrement 

* count 




tst,w 


do 


* finished? 




bne 


moveloop 


* nope 



Because compilers are not as quick to grasp the big picture 
as people are, some extra steps are included. This fragment 
would be better written something like this: 



movelo op : move , b 
movecheck: dbf 



(a5)-f,(a4) + 
d7, moveloop 



* check for 

* zero count 

* *d+ + - *s+ - 

* decrement 

* count, continue 



or, when possible, by longwords instead of bytes, like this: 



bra 
moveloop; move.! 
movecheck: dbf 



movecheck 
(a5) + ,(a4) + 
d7, movelo op 



A longword (four bytes) is the largest piece of memory the 
ST's processor can handle at once. Thus, it is the ST's most ef- 
ficient chunk size for doing things like moving memory 
around. The longword moves in the above code fragments will 
move their four-byte chunks nearly three limes faster than 
their byte-by-byte siblings. 

The speed difference becomes telling when very large 
chunks of memory must be moved around. Using the above 
code fragments, the Atari 520ST moves a chunk of memory 
the size of its own screen at 150, 96 and 33 milliseconds. 



Those figures are not a straight 8 MHz multiplication of the 
number of clock cycles the MC68000 takes to perform the 
steps listed. Overhead slows the ST down to an apparent 
speed of about 7,3 MHz. 

AND NOT ONLY THAT 

Just a few more points before we plunge into our "printout" 
module. 

Whenever possible, everything is done with longwords in- 
stead of the bytes the procedures are defined as using, "When- 
ever possible" means two conditions must be met: the move 
must be longer than four bytes, and it must involve even ad- 
dresses. The MC68000 is incapable of doing longword mem- 
ory 1/0 at an odd address. If the situation can't meet both 
conditions, or can't be rearranged to meet them, the moves 
must be done by the byte. 

Thus, these procedures really do not represent the fastest 
way to do the job. They spend too much time setting them- 
selves up and deciding the best way to go about their busi- 
ness. But they are completely general and work no matter what 
parameters they are given to work with- — unless, of course, 
they are sent bogus addresses or negative counts or similarly 
impolite things. Once they do decide on the best way Co go 
about their job, chough, they do it as quickly as possible and 
are an excellent compromise between generality and perform- 
ance. For an example of their usage, examine the code in 
PRINTOUT.C, which we talk about next. 

CONFESSIONS OF A FILE PRINTER 

l'RINTOUT,C, on your START disk, is the source code for a 
self-contained, (nearly) stand-alone C module that reads stan- 
dard text files from a disk and displays them to either a 
printer or the screen. The resulting display will be left-justified 
and word-wrapped on the right margin. It is completely inde- 
pendent of text size and Atari ST screen configuration. On the 
printer, PRINTOUT paginates when the page is full. On the 
screen, it begins at the top of its own window and continues 
to the bottom. When that bottom is reached, the window is 
scrolled and printing continues smoothly. The patient human 
watching all of this can pause or stop the display at any time, 

PRINTOUT is a slightly modified version of a module in 
Antic's Disk Doctor. All printing in Disk Doctor is routed 
through this unit, but the modified version here is slanted to- 
ward displaying help files. All that need be done to read and 
show a help file is call showfile(), sending it the name of the 
help file it should show. 

Again, PRINTOUT was developed using DRI's C Compiler. 
If you use some other compiler, beware that the Alcyon crea- 
ture has some idiosyncrasies. Paramount among these is that it 



SI AM!. Ibe Sr Quarterly 



PROCEDURES 



does not exactly follow the C convention ol interchangeable 
poiniers and integers; integers being only cwo-byte entities, 

PRINTOUT needs six things it does not define itself. These 
are: int schandle, the work screen handle returned by v_ 
opnvwkO at program initialization; int cellwidth, the cell 
width of the current text font and size; int cellheight. its cell 
height (see GEM's vst_height() for details on these); and 
ptsinf], a temporary int array which must be defined for any 
GEM application, anyway, so why not: use it? 

The fifth and sixth items are initializations, not variables. 
You must be sure the fill color is set to the background color, 
and text alignment must be set to bottom. 

To provide an example of hooking PRINTOUT to an ap- 
plication, there is a simple shell program called PRTSHELL.C 
on your START disk. PRTSHELL.C will open a GEM virtual 
workstation, take over the screen, arrange things the way 



ricking up the 

screen at any arbitrary point on 

a line and moving it somewhere 

else presents a fairly ugly 

problem. 



PRINTOUT wants them, display a menu bar, then wait for 
menu messages. Two menus are included for your enjoyment. 
One is the standard Desk Menu, the other is a Help Menu. 

The first item under the Help Menu is "Quit". The remain- 
ing two items are psuedo Help items titled "About Something" 
and "About Something Else". They both call showfileO from 
PRINTOUT and display text from one of two files on the 
START disk (labeled FILE ONE and FILE.TWO). 

PRINTOUT FHOM INSIDE OUT 

With a handy listing in front of you, notice that gemdefs.h is 
included for its window manager #define's, and osbind.h for 
its library bindings. Note that PAGELENGTH and 
PAGEWIDTH are also #define's. They can just as easily be 
variables carried over from the main unit. They are used only 
when printing, not when displaying to the screen. 

The first procedures of real interest are in the section 
headed "Priming Routines." The first of these is scrollO, 



which moves the entire display window up one line. It is the 
only abstruse algorithm in the entire module, and many allow- 
ances are made for it elsewhere. It is best explained by first ex- 
amining the structure of the Atari ST's screen. 

C^omplication number one is that three different screen 
configurations exist: low, medium and high-resolution. High- 
resolution screens, capable of only two colors, are mapped in 
memory very simply: bit by bit, a in the screen memory 
means that pixel of the screen is background color, A 1 means 
it isn't background. At 640 pixels wide, each line of the screen 
is 640/8 or 80 bytes wide. Each consecutive line is stored 
consecutively in memory. It's all easy enough, until you con- 
sider color screens. 

Each pixel of a medium-resolution screen is capable of 
being one of four colors. In low- resolution, that's 16 colors. 
Strangely enough, that means each pixel of a medium -resolu- 
tion screen is described by two bits of screen memory, and 
four bits in low- resolution. In fact, the screen is described in 
groups of 16 pixels. Each group of sixteen pixels is described 
by a group of two or four words of memory in medium of low- 
resolution. Specifically, the nth pixel is described by the nth 
bit of each word. In pictures, a memory map for a medium- 
resolution screen with pixels a through z looks like this: 

■■-word one— j| ■--word two— [| ---word three . . 
abcdefghijklmnopabcdefghijklmnopqrstuv'wxyz . . . 

Now, back to scroU(). Clearly, picking up the screen at any 
arbitrary point on a line and moving it somewhere else pres- 
ents a fairly ugly problem. Picking it up at pixels which hap- 
pen to fall on word boundaries is, however, fairiy easy For 
this reason, only a subset of the display window is actually 
scrolled. This is the part that begins at the leftmost part of the 
window that falls on a 16-pixel boundary and continues for 
the largest multiple of 16 pixels contained in the window. The 
scrolled portion of the window also omits a few lines on top 
and bottom for headers and messages and the like. Every 
screen line begins on a 16-pixel boundary, so vertical move- 
ment is not a problem. This is the origin of scrollrecti 1 , a 
subset of the work area of the display window (windrect[ ]). It 
was an intentional design consideration to use a subset of the 
window, rather than define the window itself to sit on a word 
boundary, because some border area was desired. 

As mentioned before, a single line on a high-resolution 
screen is 80 bytes, or 40 words, wide. It turns out that both 
color screens are lines 80 words wide. Enter linesize. 

To have the window show up anywhere on the screen, you 
need only have it show up somewhere else in the openwind() 
procedure. Since the scrolling area can then start nearly any- 
where, scroUO needs to know how far from the beginning of 
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the line (Iclt edge ol the screen) scrollrect[] is located. Enter 
linestart. 

The window is also variable size, and a third thing scroII() 
needs to know is how wide scroUrectl j is, m bytes. Enter 
linewidth. 

Note that linesize and linestart are defined as a number of 
words, while linewidth is a number of bytes. This is because 
the memory location of the screen is kept track of by an int 
pointer, and so offsets from it are done by the word. The 
movement of memory itself is accomplished by the eariier de- 
scribed movmemO, which works by the byte- — so linewidth 
follows suit. 

To calculate linewidth and linestart, the appropriate 
measurement in pixels is first divided by eight or sixteen, 
which converts to bytes and words, respectively. Each is then 
multiplied by the number of planes the current screen has: 
one for high- resolution, two for medium and Four for low, 
scrolIO accompUshes this with bit shifts instead of actual mul- 
tipHcation and division, because it is more convenient and ten 
times faster. 

Once all this preliminary stuff is knocked out of the way, 
scrollO begins one line (dy pixels) from the top of the scroll 
area and, using sheer brute force (movmemO), grabs each line 
of the window and moves it up dy pixels. 

EVERYTHING ELSE 

The remainder of PRINTOUT is best understood by watching 
it print a hypothetical file. This is accomplished by calling 
showfileO which opens the file and then keeps track of its 
length. This is necessary because read() in some earlier ver- 
sions of the operating system choked when asked to read more 
data than remained in a file. startprint() initializes all local 
variables that need initialization, and in general prepares the 
print session. 

Our other previously described AL routine, setmemO, may 
be found in centerhdr(). This is a minor function which cen- 
ters a string on the page. movmem() is used to move the 
string to the right, setmemO fills the leftmost — or first part 
of the string — with blanks. 

Our file is now read sequentially and given to the mercies 
of printsirO, piece by piece. printstr() can alter the value of 
oktocontinue. Finally, endprintC) releases all the memory 
that startprintO snatched and closes the window it opened. 
Other things are cleaned up, and the show is over. 

prinistrC) does the printing. It takes a null-terminated 
string of arbitrary length and heritage and plasters it all over 
the printer or screen, as requested by startprint(), 

printstrO itself just searches for word boundaries and de- 
cides what will fit on each line of the display. All actual print- 



ing is done, one character at a time, by printchar(). 

printcharO keeps track of the current column and line 
numbers, which are the globals cured and curline. When 
curline gets too big it causes pagination. printchar() lets 
printstrO handle line breaks when curcol gets too big. If the 
printing destination chosen is the printer, printcharO calls 
the appropriate bios trap that tells the printer about it. If 
printing to the screen, however, it stores each character in a 
one-line buffer called prnbuffer, at the index pbindex. The 
buffer is only printed when a carriage return character is en- 
countered, scpixel is an indicator of vertical position, like 
curline, but refers to the screen position instead of the line 
number. When scpixel gets too big, scrolling happens. 
scpixel is really used only for screen output and curline is re- 
ally used only for printer output, since screen output isn't pagi- 
nated, but it could be, and their uses aren't parallel; they are 
two separate variables. 

As each newline is encountered, printcharO calls 
checkeydownO, which polls the keyboard. If checkeydown() 
finds a keystroke waiting patiently for attention, it eats it and 
pauses, stops or ignores it entirely depending on the key. 

Pausing and stopping are accomplished through 
statuslineO, which prints an appropriate message and waits 
for additional keystrokes to eat, 

CRITIQUE AND OVERVIEW 

PRINTOUT'S most damning problem is that it is what mouse- 
and-menu programmers are fond of calling "modal." When 
printing, all control of the computer is taken away from the no 
doubt unappreciative human who paid for the thing. This is 
not so bad. but when the printing pauses, and the mouse re- 
turns from wherever it was and the computer is once more 
paying attention to the human, PRINTOUT is off in its own 
little world, waiting for one thing and one thing only: a key- 
stroke telling it to continue. There is no accessing any menu or 
other control device on the screen. 

The advantage corresponding to all this rampant modalism 
is that PRINTOUT is a self-contained module which works al- 
most by itself with no supervision from the main one. Making 
PRINTOUT nonmodal would of course necessitate a very inti- 
mate intertwining of its code with the main module, and it 
could hardly be published in its current incarnation as generic 
printing code. ■ 
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A detailed look at the art of debugging the 68000, plus a 
dream list of what the hest-dressed 68000 debugger may 
be wearing this season. 



■ M forking in the department of Neurosurgery at Emery University and Grady 
mm mm f^^'^^o^''^' Hospital in Atlanta showed me the similarity between the medical 
V ■ diagnostic process and the process of debugging a computer program. I was 
struck by the importance physicians place on information they see with their own eyes, 
and indeed, many of the recent advances in medical diagnosis come from instruments 
that provide images of our internal bodily processes. 

Similarly, it makes sense to improve debugging tools by improving our ability to "see" 
what's going on inside our programs at any instant. One reason debugging is so difficult is 
that bugs usually involve some assumption that proves to be untrue. We intend to do one 
thing, but in reality we do something else. This mindset makes it hard to locate bugs, 
because we're so sure that it couldn't possibly be in a certain part of the code. One way of 
countering this in debugging is to put as much information as possible on the screen and 
let our visual system recognize when things don't look right- You've probably noticed how 
much easier it is to recognize the right answer on a multiple choice test than it is to 
generate the right answer in a fill-in-the-blank test, ^ 
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BUG, BUG, WHERE'S THE BUG? 

You're writing a program, and when you test it, it doesn't 
work. What now? At the risk of seeming simpUstic, there are 
two things to do: Determine the bug's symptoms, and discover 
where the bug occurs. 

As a general rule, fixing a software bug is usually easy; 
finding it is the problem. Some of the basic tools we use to 
find it are: 

• A breakpoint mechanism; A way of setting a point in memory 
so that, if the program tries to execute chat particular instruc- 
tion, control transfers to the debugging system. 

' A register display routine: To figure out what's going wrong 
in a program, the first step is to examine the processor 
registers. 

• A memory display routine: Next in importance to the proc- 
essor state is the current state of memory. We obviously need 
an easy way to examine exactly what's out in memory. 

• A single-step mechanism: We want to make the processor 
execute a single instruction at a time, returning control to us 
after each instruction. Then we can "watch" precisely what is 
happening in the program, and see when it goes wrong. 

• A trace mechanism: An elaboration of the single-step mecha- 
nism. Here we want to run the program in an interpretive 
mode, automatically making certain tests, recording machine 
states, and so on. 

So far everything I've said applies more or less equally to all 
computer systems and languages. The closer to assembly lan- 
guage you work, the more you have to know about the proc- 
essor itself. In the Atari 520 (or 1040) ST, that means the 
68000. For many of us, the 68000 is the second or third mi- 
croprocessor we have worked with, so what we really need to 
know is what aspects of 68000 assembly language program- 
ming are different from that of other processors. When you 
scop and think about it, the areas where any processor differs 
from others can be grouped into several main classes: 

1. Register-Set Architecture. 

2. Addressing Modes. 

3. Instruction Set. 

4. Special Event Handling, 

The next sections discuss features in each of these areas 
that are likely to be unique to the 68000. 

REGISTER-SET ARCHITECTURE 

The first thing we notice in looking at the 68000's register-set 
architecture is how many registers there are: seventeen 32-bit 
registers in addition to a 32-bit program counter and a 16-bit 
status register. The data registers D0-D7 are the true general 
purpose registers of the 68000, The next group, address regis- 



ters A0-A6, is used mainly tor address operations. There are 
some restrictions governing which instructions work with the 
address registers. Also, some operations on these registers 
don't affect status register bits. All in all, even though the ad- 
dress registers seem at first to be just hke the data registers, 
they are, in fact, quite different. 

The status register is divided into two bytes, the system 
byte and the user byte. These two registers contain a total of 
10 bits of status information. Of these 10 bits, two are es- 
pecially meaningful for debugging purposes, the S bit and the 
T bit. The S bit determines which of two possible states the 
68000 is in, either Supervisor or User, In Supervisor mode, 
there are several privileged instructions that can be executed, 
but they will generate an error in user mode. The S bit also 
determines which of two possible stack pointers will be used. 

The T bit, or Trace bit, is very important to debugging. 
When this bit is on, an exception (i.e., internal interrupt) is 
generated after each instruction. In effect, this is a built-in, 
single-step mechanism, 

ADDRESSING MODES 

The 68000 has 14 available addressing modes, most of which 
can be used with any instruction. The main classes of ad- 
dressing modes include: 

■ Register Direct Addressing. 

• Absolute Data Addressing, 

• Program Counter Relative Addressing. 

• Register Indirect Addressing, 

• Immediate Data Addressing. 

• Implied Addressing. 

Most of these modes are familiar to you from other sys- 
tems, but there are a few things to notice. For instance, the 
Postincrement Register Indirect and the Predecrement Register 
Indirect modes are specifically included to provide for stack 
processing. Remember, however, that postincrement changes 
the address register after using the contents, as opposed to be- 
fore with the preincrement mode. Also, the size of the incre- 
ment is determined by the size of the instruction (e.g., byte 
instructions increment by 1, word instructions by 2, and long 
word by 4). Take care in using either of these modes with reg- 
ister A7 (the stack pointer). Since the system uses this register 
(and the implied stack) for address storage in subroutine link- 
age, the system always expects this register to be aligned on 
an even address. So even for byte-sized operations, the value 
of A7 will be adjusted by two. 

One of the 68000 addressing capability's features is the 
ability to write position independent code, i.e., object code 
that can be moved around and still execute without change. 
The 68000 allows this by providing an addressing mode that 
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is relative to the program counter. Several other processors al- 
low relative branches, but in the 68000 even JUMPS and sub- 
routine calls can be made relative to the program counter. 

This is not to say that there aren't some quirks in 68000 
addressing. The 68000 designers also put in some features to 
encourage reentrant code. For instance, you can read data rel- 
ative to the program counter, but you can't alter data. Ob- 
viously, this is to protect the program from overwriting itself. 
Self-modifying code is considered outmoded these days. Data 
can be referenced, relative to a base address set up in a regis- 
ter, to encourage separation of program data and code. 
Though most instructions work with most addressing modes, 
there are exceptions, 

INSTRUCTION SET 

The 68000 instruction set has only 56 instructions. But the 
ability for these instructions to work in many of the address- 
ing modes and on several different data sizes makes them 
seem more numerous. For instance, the CLR command (which 
is a quick way of setting a location to 0) can be written sev- 
eral ways: 

CLR (A3) Clears the word pointed to by A3 

CLR,B (A3) Clears the byte pointed to by A3 

CLR.W (A3) Clears the word pointed to by A3 

CLR,L (A3) Clears the long word pointed to by A3 

Care must be taken in sizing the data field on which you 
wish to operate, especially when the destination operand is a 
register. If you are operating on less than the full-sized regis- 
ter, the remaining portion is unaffected. In practical terms, 
this means the register's upper bits might not contain what 
you think. There is a little bit of a "gotcha" here, in that byte 
operations work on the bottom 8 bits of a register, but on the 
top 8 bits of a memory location. 

Another feature, sign extend, comes from having instruc- 
tions that work on variable size data. In the CMPA instruction 
(CoMPare Address, works only with word and long sizes), if 
you choose the word size, the sign (i.e., bit 15) is sign-ex- 
tended to the full 32 bits and then the comparison is made. 
This can lead to some non-intuitive situations. For instance, 

CMPAW #$FFFF,A1 

would set the Z condition code if Al contained -I 
(SFFFFFFFF), and would not set Z if Al contained SFFFF It 
is always a good idea to use long versions of instructions when 
placing addresses into address registers. 

Several instructions are specifically included for high-level 
language support. Some of these can aid the debugging proc- 
ess. When taking a "snapshot" of the processor state during a 



program execution, there is always the question of which reg- 
isters to save before the snap-shot subroutine executes. The 
MOVEM copies a specified set of registers to memory or back 
again. This instruction is very flexible, and able to save or re- 
store any arbitrary group of registers. The machine language 
instruction actually contains a 16-bit register mask where each 
bit set to "1" indicates that the corresponding register should 
be saved or restored. Be careful when using this instruction to 
move 16-bit words from memory to address registers; they will 
be sign extended to 32 bits. 

The DBcc (Decrement and Branch on condition) is a useful 
loop control command. Remember that the condition specified 
is the one that makes the program exit the loop, rather than 
stay in the loop. If the condition is not met, the counter will 
be decremented and tested for -1, If your loops are off by 1, 
this would be a good place to check. 

An instruction is provided for multiprocess communica- 
tion. In time-sharing situations, there is a classic problem 
known as the "deadly embrace," which can occur when two 
processes that are interrupt-driven both try to exert control at 
the same time. If a section of code first tries to read a status 
value, then takes control based upon the value's state, there 
could be trouble. What happens, for instance, if an interrupt 
occurs after the reading of the value, but before it is set to a 
new value? It depends. To help avoid such pitfalls, the TAS 
(Test and Set) instruction allows you to read, test and set a 
value all in one instruction. This allows the code to set a sem- 
aphore. 

If you've come to the 68000 from a less powerful proc- 
essor, there will be numerous pleasant surprises for you. Ex- 
amples are: The bit-testing and setting instructions (BCHG, 
BCLR and BTST), the multiply and divide instructions, the ex- 
change register instruction, some of the conditional branch in- 
structions, and the data movement instructions. 

The 68000 contains conditional branching instructions that 
test individual status register bits. There are also conditional 
branch instructions that on other processors require several 
instructions, including BLT, BGE, BLS, BLE and BGT, The most 
complicated of these are the "Branch if Less than or Equal" 
(BLE) and "Branch if Greater Than" (BGT). BLE will jump if 
the Z bit is set, or if the N bit is set and the V bit is not set. 

The Bit TeST instruction, BTST, is a weird little instruction 
used for testing if a specified bit is set. The weird thing is that 
the instruction's action depends upon whether the destination 
is a memory location or a data register. The low order bit is 
specified as bit 0, and the high order bit as bit 7, Numbers 
larger than 7 are regarded as modulo 8. Memory is addressed, 
then, by bytes. If, however, a data register is the destination, 
then bit numbers range from to 31, allowing all the register's 
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bits CO be tested- If the number is larger than 31 it is consid- 
ered CO be modulo 32. 

Take care with the other bit-oriented instructions also. The 
68000 uses memory-mapped I/O, so it is tempting to want to 
use an instruction hke BSET to sec a bit in a peripheral scacus 
register. What really happens in a BSET instruction however, 
is a read-alter-write sequence. Some peripherals are sec up to 
become active whenever their address appears on the address 
bus. Thus, some subtle bugs can occur when you try to acti- 
vate individual bits, A better approach is to use a MOVE in- 
struction to set the register all at once. 

SPECIAL EVENT HANDLING 

In the 68000, interrupts and other special events are known 
as exceptions. Exceptions are caused by external events 
known as interrupts; those caused by internal events are 
traps. The 68000 designers included several features to aid de- 
tection of program bugs. Specific hardware traps detect the fol- 
lowing conditions: 

• Word Access with an Odd Address, 

• Illegal Instructions, 

■ Unimplemented Instructions. 

• Illegal Memory Access (Bus Error). 

• Divide by Zero. 

■ Overflow Condition Code (Separate Instruction TRAPV). 

• Register Out of Bounds (CHK Instruction). 
' Spurious Interrupt, 

Also, programmers may use the 16 TRAP instructions to 
provide applications- oriented error detection and correction 
routines. 

Finally, the CHecK register against bounds (CHK) instruc- 
tion checks array bounds by verifying that a data register con- 
tains a valid subscript, A trap occurs if the register contents 
are negative or greater than a limit, 

BUILDING A BETTER DEBUGGER 

Having examined 68000 features that can affect the debug- 
ging process, we return to the problem oi using Atari ST fea- 
mres to aid in debugging. Color graphics and animation come 
to mind immediately. One example is to switch screens be- 
tween the normal program display screen and a special debug- 
ger screen, which works because the ST has registers that 
determine where the video RAM (i,e,, what the screen dis- 
plays) is located. Visuals can be done in monochrome or color, 
I'm partial to color, and sacrifice resolution in order to use 
color to signify special events (e.g,, a data value changing). 
The real challenge is to find ways to use the machine's graphic 
capability to display what the processor is doing. Indeed, nu- 



merous instruments are available to do this including: logic 
analyzers, signature analyzers, and performance analyzers. 

Let's look at what we might call a program execution space 
display Suppose we create a graphic display where a vertical 
line represents the memory space available to your system. 
Test the program in "trace" mode and it could display a col- 
ored pixel along the memory space line Co indicate where the 
program counter is set. These pixels may even be tracked 
horizontally, creating a histogram of how many times a partic- 
ular instruction has been executed. Just by watching such a 
display, we could get an intuitive "feel" for where the program 
is spending its time. 

Similarly, a series of icons could be created that stand for 
some of the routines the program might execute. The trace 
program could highlight the icon of each routine as the routine 
is entered, thereby displaying the program's rough flow. This 
might not tell us the details of what went wrong, but it could 
provide some clues of where we should look more closely, 

PROCESSOR AND MEMORY 

Once we have built a better display mechanism we still need 
ways of setting up a particular machine state and controlling 
the processor Every debugger available has instructions for 
setting processor registers to specific values, and for depositing 
values to memory However, some are easier than others, A 
powerful addition in this area is to allow symbolic references 
to variables from the debugging tool. Typically this means that 
the debugger must have access to the symbol table used by the 
assembler or linker or have a provision for defining symbols 
interactively, 

A second way of improving our processor and state control 
is to allow conditional breakpoints. Simple, unconditional 
breakpoints are helpful. But ones with which you can, for ex- 
ample, say "Break" if an instruction tries to write to location 
TEST, are much better. Other types of conditional breakpoints 
are ones that break on specific instructions, program branches 
to specific ranges, and data accesses within specific ranges, 

A speed control mechanism for single-step mode is also 
quite useful. Sometimes we just want to watch the overall flow 
of the program, while at other times we wane to watch the de- 
tails of specific instructions as they are executed, 

Vvfe should also take advantage of the function keys and Mr 
Mouse, These concrols can crigger special kinds of debugger 
displays or processor control. The special function keys can be 
used for: 

• Returning to the program under test. 

• Single stepping the program, 

• Switching screens between the program and debugger ► 
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DEBUGGING 
GLOSSARY 



ASCII Chart - A table showing each keycode's ASCII 
value. Some debuggers provide this as a convenience 
for lov/-level I/O debugging. 

Assembler - A program that translates mnemonics 
meaningful to a programmer to executable object 
code. 

In-line Assembler - A provision allowing a debug- 
ger user to deposit values in memory by using 
mnemonics without having to refurn to the assembler. 
Sometimes called an immediate assembler 

Backtracking - The ability to "go backwards" in time 
and undo the effects of preceding instructions. Re- 
quires a buffer to store the preceding instructions and 
some processor or memory state information. 

Breakpoint - A point where execution of the tested 
program stops and control returns to the debugger 

Conditional Breakpoints - The ability to specify 
a set of conditions that determine whether a break- 
point will be triggered. 

Sticky Breakpoints - Breakpoints that remain in 
place even after they have been triggered. They must 
be explicitly cleared. 

Calculator - A provision to do some degree of arith- 
metic or expression evaluation directly in the debug- 
ger (e.g. calculating an effective address). 

Decimal Arithmetic - Arithmetic capabilities in base 
10. 

Hex Arithmetic - tiexadecimal (base 16) capability. 

Compare Capability - The ability to compare a 
given memory range to another memory range. Done 
properly, such a feature will show at what point the 
comparison fails, if it does. 

Communication Ports - The ability to use an exter- 
nal communication port for communicating with the 
debugger. This is usually important for debugging ap- 
plications that run on systems where there is limited 
ability to control the screen memory. 

Debugger Isolation - Provides some degree of 
!i isobfion between the debugger and the system under 



test. This is usually seen in systems with additional 
memory cords or In-Circuit Emulators. 

Disassembler (Unassembler) - A program that 
converts between object code and assembly lan- 
guage mnemonics. Most debuggers have a provision 
for displaying a portion of memory in disassembly for- 
mat. 

Fill Memory - The ability to set a range of memory to 
a specified value or pattern. 

Firewalling - A preventative debugging technique 
where modules are isolated from each other and in- 
teract only by affecting a group of variables. 

Hardware Assisted Debugger A debugging 
system that is provided with some additional hard- 
ware. Examples might be extra RAM, a hardware 
switch that generates an interrupt, or an In-Circuit Em- 
ulator sysfem. 

Help Screens - Display screens internal to the de- 
bugger that explain its functions. 

In Circuit Emulators (ICEs) - A hardware assisted 
debugger that is in fact a complete external computer. 
Usually includes a cable and integrated -circuit plug-in 
device that replaces the target processor. In effect, 
the external computer system "emulates" the micro- 
processor under test. 

Interrupts - Various conditions, or exceptions (as they 
are called on the 68000), that cause a hardware in- 
terrupt to be generated. These cause jumps through a 
vector table to interrupt processing code. 

Linkers - Programs that load object code modules 
and resolve external symbol references. 

Logic Analyzers - An instrument thai monitors the 
busses of microprocessor systems, as well as allowing 
probes of other locations inside the system. A display 
much like an oscilloscope is created, showing the logic 
state over time for the line or point being monitored. 

Map Files - Intermediate files produced by some as- 
semblers that detail local symbols, local routines, ex- 
ternal symbols and routines that are referenced, etc. 

Move Memory - The ability to move a block of 
memory from one location to another 

Non-Maskable Interrupt - (NMI) on interrupt that 
can't be ignored by the processor. In the 68000, this 
con be implemented by setting the interrupt priority to 
7. 

NMI Switch - A "breakout" type of switch that is 
wired to generate a Non-Maskable (hiighest Priority) 
interrupt. This is usually intended to return control to I 
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the debugger offer the program under test has 
bombed. 

Overlays - Additional portions of executable code 
that are brought in and "overlay" the code currently in 
memory. This is one technique for creating programs 
that are bigger than the physical memory size. 

Patching - The ability to make local temporary 
changes to object code for quick testing. 

Code Insertion - The ability to patch a section of 
new code without affecting the existing code. 

Performance Analyzer - A device or program 
that captures processor execution information. Typ- 
ically used to determine where the processor is 
spending its time, how many times particular routines 
are called, or specific timing information about a code 
fragment. 

Protected RAM - RAM that is provided with some 
debuggers where the debugging system can maintain 
information thai is protected from the program under 
test. 

Reduced Speed Execution - Ability to run the 
program under test in a reduced speed interpretive 
mode where the action of the processor is slowed 
down so the user can roughly follow what is 
happening. 

Screen Toggle - Ability to switch back and forth be- 
tween o user-program screen display and the debug 
display. 

Search Capability - The ability to search through 
memory for a given value or pattern. Usually updates 
a display to show the next memory range where a 
match is found. 

Signature Analyzers - A testing device that cre- 
ates a visual display representing what the processor 
is doing. Particular programs turn out to have repeat- 
able, easily recognizable patterns. 

Single Step - Ability to cause the processor to ex- 
ecute a single instruction and then return control to 
the debugger. 

Single Step Past Calls - Ability to place a break- 
point beyond a subroutine call so that the processor 
executes a subroutine and then returns to the debug- 
ger after returning from the subroutine. 

Sleeping Debugging Instructions - Diagnostic 
instructions or routines that ore normally inactive, and 
which "wake up" and execute when a predefined ab- 
normal condition occurs. 



Source Level Debuggers - Debuggers that have 
some provision for reading source level code files and 
correlating those with the object code currently being 
debugged. A display is usually provided that shows 
the source language statement that contributed the in- 
structions currently being executed. More sophisti- 
cated source level debuggers allow for breakpoints to 
be set at the source level. 

Snap Shots - A static representation of the processor 
and memory state at any instant. Gives the debugger 
user a picture of what's going on in the processor at 
that instant. 

Symbols - A sequence of characters that stands for 
either a memory location or a data value. The ability 
to use symbols mokes debugging much easier. 

Public Symbols - Symbols that are defined in gen- 
eral function libraries and are available to all program - 
users. 

Symbolic Debugging - The ability of the debugger 
to refer to a symbol table to make disassembly for- 
mats closer to assembly or other source languages. 

Trace - The ability to monitor the processor and/or 
memory sfofe offer each ;nsfrucf/on is executed. This 
is used for single stepping, conditional breakpoints, 
creating log files, and backtracking. 

Watchpoints - Conditional types of breakpoints 
where certain conditions are monitored, and if they 
are satisfied, then control returns to the debugger. 

Windows - A porfion of o screen display (usually rec- 
tangular) that can be set up to monitor particular 
memory ranges, symbols, or other types of data 
structures. 

Wolf Fence Method - A debugging technique 
where a bug is located by successively fencing it in 
smaller and smaller areas of code. 



• Activating special data displays, 

• Scrolling a symbol table display. 

• Changing the representation of memory window displays, 

• Saving the current state to a disk file. 

• Activating trace mode. 

• Turning on a buffer mechanism to store instructions that 
have been executed. 

The mouse can quickly point to exactly which register to 
change, which symbol to monitor, the speed of execution, or 
where in memory we want to look. The combination of a high- 
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quality graphic display and a pointing device that can quickly 
indicate any spot in that display is a powerful one indeed. 

ONE STEP BEYOND 

All of the features discussed so far can be found on existing 
debuggers if you look hard enough (though no one debugger 
has all of them). So what's the next step? Use your imagina- 
tion. Are there other ways ro visually represent the processor's 
activity? You bet there are. And I haven't even mentioned the 
possibilities of adding sound. The 68000 is a very powerful 
processor and the Atari ST combines this processor with ex- 
cellent graphic capability 

We've just begun to tap the possibities of this combination 
in all areas of programming, including debugging. It still takes 
too long to go from an idea to a working program. Too much 
time is spent exorcising bugs. Don't you think it's time our 
programming tools were a little more sophisticated? It wouldn't 
surprise me a bit to see a whole new class of debugging pro- 
grams emerge soon for the Atari ST. And not a minute too 
soon. 

(Editor's note; Jim Dunion is currently putting the finishing 
touches on 5TDDT, his debugger for the Atari ST. It will be inter- 
esting to see if Jim can fit all the features mentioned in this arti- 
cle into STDDT.) 

REFERENCE: 

' M68000 16/32-bit Microprocessor Programmer's Reference 
Manual (fourth edition), by Motorola, Prentice-Hall, En- 
glewood, NJ 

• Motorola Data Sheets: 
68000— #AD1-814 
68008— #ADl-939 

68010— #AD]-942 

• 68000 Assembly Language Programming, by Kane, Hawkins, 
and Levanthal, Osborne/McGraw-Hill, Berkeley, CA 

• Programming the M68000, by Tim King and Brian Knight, 
Addison -Wesley, Reading, MA 

• The Motorola MC68000 Microprocessor Family, by Thomas 
L. Harmon and Barbara Lawson, Prentice-Hall, Englewood 
Cliffs, NJ 

• The 68000: Principles and Programming, by Leo J. Scanlon, 
Howard W, Sams & Co., Indianapolis, IN ■ 

Remember, START is not complete without its disk. To 
order, see handy order form. 
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WE SPECIALIZE IN ST SOFTWARE 

JOIN OUR ST OWNER'S CLUB 

FOR FREQUENT SOFTWARE AND 

HARDWARE UPDATES CALL NOW! 

ATARI ST SOFTWARE 



DEGAS 

CHECKMINDER . 
H £ D BASE 


S 25.00 

. . . 39.00 

59.00 


REGENT BASE . . . 
REGENT SPELL . . 
REGENT WORD . . 
SILENT SERVICE , 
ST COPY (CCI) . . . 
THE PAWN 


, S59.95 

. . 35.95 

35.95 


HIPPO PIXEL , . . 


. . . 27.95 


. 23.95 


LATTICE 'C 

M-DISK. 


109.95 
24.95 


. . 27.95 
29.95 


P/C INTERCOM 


. . . 69.95 


TYPESETTER ST . 


. . 24.95 



WE CARRY THE MOST EXTENSIVE AND 
COMPREHENDABLE LINE OF MIDI SOFT- 
WARE, HARDWARE, AND ACCESSORRIES. 
CALL NOW FOR AVAILABILITY! 

HARDWARE 

CASIO CZ-101 MIDI SYNTHESIZER S309.00 

CITIZEN MSP-10 DOT MATRIX PRINTER .... 265.00 

HAYES 1200 BAUD MODEM 375.00 

HIPPO EPROM BURNER 109.00 

HIPPO ST SOUND DIGITIZER 109.00 

HIPPO ST VIDEO DIGITIZER 109.00 

QMI 1200 BAUD MODEM 159.00 

We guarantee to beat any advertised price Call 
the Bozos, then call your ST EXPERTS! 
WE'RE FAST, WE'RE FRIENDLY 

CALL OR WRITE TO BE PLACED ON MAILING LIST 

FOR NEW PRODUCT INFO AND MEMBERSHIP 

P.O. Box 3025, Northridge, CA 91323 



NAT'L 1(800)423-3444 
CALIF 1 (800) 424-3444 
LOCAL (818)886-5486 
YOUB .^„ 
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YOUR ATARI 520ST SOFTWARE SUPPORT CENTER 



ACTIVISION 



ACADEMV 

Tyoing Tuloi 
ATARI 



BATTERIES INCLUDED 

Paperclip Elilo 
DRAGON GROUP 



^ills 



C Compiler . 

Checkminder 

HABA Writer 

Phone Book 

HabadiskdOMegl,. 



llaba Calc & Graph 
Haba Hailroorr 
ilaba Word 



Hippo ST Disk Uti 
Hippo ST fiarrdis' 
Hippospell 

Hpopobackgammi 
HippoconcepI . . . 



Hippo ST Sound DielClze 
Hippo Video Digitizer 
Hippo Eptom Burner 



H&D Base 
INFOCOM 
Ballvhoo ... 



Hitchdikei-s Guide . 

Seastalker 

Sorcerer 



Plane 



2a 



Spellbreaker . . . 

StarcrosE 

Suspended 34 

MARK OF THE UNICORN 

PC Intercom . . . . 84 

.... 28 



METACOMCO 



Met a Pascal 
MICHTRON 

DOSSIiell. . 



Personal Money Mgr. 



Major Motion 
Mi-Eupe 
Hlghty Hall 



DIGRAPH 
MINDSCAPE 



Sundog 
OSS 

Personal Pascal . , 
Personal Prolog . . 
PHILON 

Compiled Basic . . 

PRYOHITV 



mOues 



OMI 

ST Talk 

QUICKVIEW SYSTEMS 

Zoomrachs 

SIERRA 

Kings Quest II 






SST SYSTEMS 

Chat 

SUBLOGIC 



XLENT 

Typesetter 

Rubber Stamp . . 



Atari ST Basic Trainlr 
Atari ST Graphic & Sol 
Atari ST Logo 
Atari ST Peeks & Poke; 
Atari ST for Deginnert 



iri ST GEM Referf 
irl ST Internals 
iri ST Machine La 
iri ST Tips S Tri 
irl ST from Eoaic 



FLOPPY DISKS AS LOW AS SSit EA. 



5 -A" 


Black Generic Bulk ; 


Bulk 


SS/DD 


DS/DD 


20-69 


.69 ea. 


,89 ea. 


7D+ 


.59 ea. 


.79 ea. 



3V2' 


Verbatim 


Sony 


Sony 


Bulk/8x. (5) 


SS/DD 


SS/DD 


DS/DD 


20-69/2-6 


1,59 ea 


11.90 bx. 


16.90 bx. 


70+/7+ 


1.49 ea. 


10.90 bx 


15.90 bx. 




ATARI 520ST 
Persona] Computer System 

ATARI HARDWARE 
CALL FOR PRICES!! 

PACKAGE # 1 

Atari 520 STM Computer 8 SF 354 Disk Drive 

PACKAGE #2 

Atari 520STMCompijter,SF 314 Disk Drive 
and SC 1 24 Monochrome Monitor 

PACKAGE #3 

Atari 520 STM Computer, SF 354 Disk Drive 
and SC 1 24 Monoctirome Monitor 

PACKAGE #4 

Atari 520 STM Computer, SF 354 Disk Drive 
andSC 1 224 Color Monitor 

PACKAGE #5 

Atari 520 STM Computer, SF 314 Disk Drive 
and SC 1 224 Color Monitor 

Call for Package Prices! 

Let Us Design A Syslem 

To Fit Your Needs!! 

ATARI PERIPHERAL PRODUCTS 

SF 354 SS/DD Disk Drive 149 

SF 314 DS/DD Disk Drive 209 

SM 1 24 Monochrome Monitor 1 49 

SC 1224 Color Monitor ' 329 

SHD 204 5i" 20 MB Hard Disk Call 

TOS Operating Systerr 25 

Installed « 

One MEG Upgrade with purchase 

of System 100 

THIRD PARTY PRODUCTS 

Haba 5|" Hard Disk 669 

Shanner DS-2000 3^9 

520 Station 75 



^>^^>^ 



To order call TOLL FREE 

1-800-824-7506 



ORDER LINE ONLY 



^^ 






COMPUTER CREATIONS, Inc. a 



P.O. BOX 493 -DAYTON, OHIO 45459 B3 

For information, order inquiries, or for Ohio orders (513) 435-6868 



n, $4,001. Software and accessories add $3.00 shipping and hanc 
nd APO. Ohio residents add GV,% sales laj<, Canadian orOors add 
id cashier's check, money orderordirecl banktransters. Personal 

lal. NO CREDITS All detective returns must have a return authori 

repair FOR VOUR PROTECTION WE CHECK FOR CREDIT CARD 



notice. Was 


PC,0,D loContinentalLi.S, addresse 


ngmConhn 


ntBlU,S. Actual frerghlwill be charged o 


5% shipping. 


■nin. $5,001 All other foreign orders, pie 


Id company 


hecksallow 3 weeks lo clear. School pu 


Hlionnumbe 


Please call [5 1 3| 435-686B to obtain a 
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ST ASSEMBLERS 

A START COMPARISON 



BY CHRISTOPHER F, CHABRIS 



JBj year ago, the only way a programmer could do serious 
j| development work with the 520ST was with Atari's so- 
^ni called "Developer's Kit" at $300.00. Now, there are sev- 
eral high-level language compilers and four macro assemblers. 
We'll compare those assemblers and the "standard" Digital 
Research AS68 program supplied in the developer's kit. 

First, though, let's briefly review the function of an as- 
sembler in software development. An assembler is a program 
that translates a source text file composed of mnemonic com- 
mands into machine language for a particular microprocessor 
On an 8-bit Atari computer, this is exactly what happens. 
With the ST, the process can be different- Usually the as- 
sembler produces something called "object code," an inter- 
mediate file consisting of machine language instructions that 
cannot be loaded and executed directly by the computer In- 
stead, it must hrst be processed by a program called a linker. 

Why is this? Why not make the assembler simply produce 
executable files straightaway, like MAC/65 for the 8-bit ma- 
chines? There are a couple reasons. 

First, due to the MC68000's speed and rich instruction set, 
most commercial programs that run on a 68000-based com- 
puter are written in a high-level language like C or Pascal and 
compiled to run. Although the resulting program runs slower 
than its equivalent written originally in assembly language, the 
68000's speed makes the difference virtually invisible to the 
user. Software houses prefer to use high-level languages be- 
cause programs can be developed faster and are easier to port 
to other computers. Indeed, much of the early ST software was 



originally developed for other computers in C, 

Second, because of the increasing complexity of applica- 
tions software and the large size of the 68000 instructions 
themselves, executable program code is becoming larger. So, 
modular programming techniques are gaining popularity, and 
it is not uncommon to have several programmers working si- 
multaneously on the same final product. 

These reasons combine to produce the concept of separate 
compilation — dividing a large program into smaller modules 
and compiling them separately only when a change is made. 
We can create libraries of common procedures just once, in- 
stead of each time we compile the program that uses them. 
Compilers usually produce either an object file (as does Per- 
sonal Pascal from O.S.S.) or an assembly language file (as does 
Alcyon C from the developer's kit). In the latter case, the code 
would have to be assembled into an object file. In either case, 
compiling a module results in an object code file output. This 
is where the linker comes in. 

The linker can combine one or more object code files into 
an executable program under a given operating system. Since 
the object files are supposed to adhere to a standard format, 
the linker is even able to combine code from different lan- 
guages into one program. This scheme makes it easy to write 
most of an application in a high-level language and code the 
high-performance sections in assembly language, A notable ex- 
ample is the Unix operating system, which is about 90 percent 
C and 10 percent assembly language. 

For the assembly language programmer, this adds another ► 
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Step to the development cycle, but saves time in large projects. 
Atari supplies the standard DRI LINK68 program with the de- 
veloper's kit. Since the linker component defines a develop- 
ment system's object code formats, assemblers and compilers 
that produce code acceptable to this linker can be used to- 
gether in the same programming environment. 

WHAT IS AVAILABLE? 

In addition to the Atari/DRI developer's kit cools, the following 
assembly language development products were available in 
April 1986; 

• A-SEKA, Kuma Computers Ltd., version 020386 ($39.95) 
■ GST-ASM, GST Holdings Ltd., version LOO ($59.95) 

• Macro Assembler, Metacomco, version 10.195 ($79.95) 

• DevpacST, HiSoft, preliminary version 0.99 ($79.95) 
These products were developed by British firms. Each in- 
cludes a non-protected single-sided disk, and there the sim- 
ilarities end. Some include printed manuals, some use GEM 
features, and some have debugging facilities. I tested the four 
produces on a 520ST with TOS in ROM, SC1224 color 
monitor, and two single-sided SF354 disk drives. 

All four products, as well as DRI's AS68, use Motorola 
standard mnemonics and conventions. While they are for the 
most part correct, please do not get the impression that they 
are compatible with each other! I attempted to perform an in- 
formal benchmark to compare the five by assembling and 
linking an off-the-shelf 31K assembly language source file, 
(STerminal by Jeremy E. San, from the Antic public domain li- 
brary). First I tried AS68 to set the performance standard for 
the others and everything worked fine (it took 3; 19 minutes to 
assemble and a total of 4:21 minutes to create a runnable pro- 
gram file). However, none of the other programs completely ac- 
cepted the source file, and all for different reasons! The moral 
is this; choose one assembler and stick with it. Otherwise, you 
will suffer the same headaches I did attempting to convert 
source code from one program's format to another. This 
shouldn't be a problem for developers who want to program 
from the ground up exclusively in assembly language. Needless 
to say, none of the four third-party assemblers can be directly 
substituted for AS68 when developing C programs with the 
developer's kit. 

Interestingly, Metacomco packaged the GST linker with its 
Macro Assembler The documentation covers both the GST 
and DRI linkers thoroughly, but only users with developer's 
kits will have access to the latter GST-Link is incompatible 
with the DRI standard object file format, although Metacomco 
provides a utility to convert DRI format files to GST (but not 
vice versa). I'll look at the GST-Link program and the whole 
linker issue separately after the assemblers. 



Atari provides the SID (Symbolic Interactive Debugger) 
utility of CP/M 68K fame with the developer's kit, I find it in- 
adequate for all but the simplest tasks, compared even to the 
tools available on the 8-bit computers. Both A-SEKA and De- 
vpacST include debuggers, while GST -ASM and Metacomco do 
not. 

For program editing on the ST, man)" developers prefer to 
use old-fashioned, pre-GEM screen editors that offer speed 
and familiarity at the expense of ease of use. New program- 
mers may prefer a GEM-based text editor that uses menus to 
issue commands. Atari has been supplying the Micro EMACS 
editor, a microcomputer version of a popular Unix tool. 

A-SEKA 

A-SEKA IS the least expensive of the assemblers for several 
good reasons. Its scant 34-page manual lacks an index and is 
provided only as a text file on the disk, so you must print it 
out from the GEM Desktop. 

A-SEKA IS by far the fastest assembler available for the ST; 
the manual claims a rate of 30,000 lines per minute, "even for 
large files," and this is believable. All source and object code is 
kept in memory until you explicitly write it out to the disk, a 
scheme that recalls MAC/65 on the 8-bic machines. In fact, 
the entire package is similar to such products. It has no screen 
editor, only a cumbersome, anachronistic line editing scheme. 

The development process with A-SEKA looks like this: type 
in your source code line-by-line, correcting and revising with 
the Edit command; assemble it into memory; execute (and de- 
bug) the program using the Go command; repeat this process. 
Usually, code is assembled directly without linking. Some sort 
of built-in linker is provided, but the manual becomes foggy 
here. Apparently, the assembler can produce "linker code" (as 
opposed to executable code), which can later be combined 
with other such code into one executable program. 

A-SEKA is outdated. While its fast response would be 
useful for learning 68000 assembly language, and perhaps for 
writing games, it currently cannot be used for serious develop- 
ment work. It demands revision, meaningful examples, and a 
completely new manual, 

GST'ASM 

GST -ASM comes packaged in a green binder and slipcase with 
170 pages of unindexed, detailed documentation. It does the 
best job of all four in providing a complete, self-contained de- 
velopment system for AL programmers. Unfortunately, it is 
missing a debugger and documentation of TOS/GEM routines. 
The latter is available in the Abacus book series, but there is 
no good standalone debugger available as of this writing. 
GST has included GST-EDIT, an excellent windowing text 



S7'a//t. Ihc Sr Quarterly 



REVIEW 



editor reminiscent of its 1ST Word word processor, with its 
own 30-page manual. Here is an example of "overdocumenta- 
tion ," if such a thing is possible. If we could just give some of 
the extra to A-SEKA! GST-EDIT allows up to four simul- 
taneously open files with a single cut/paste buffer between 
them. On-line help is available through a pull-down mentt 

Although GST-EDIT is now my favorite text editor (replac- 
ing Micro EMACS), it has its problems. While scrolling up and 
down through a file is fast enough, jumping to the beginning 
or end is horrendously slow. More menu selections should have 
keyboard equivalents for faster operation. Ideally, the Help and 
Undo keys should also be supported. Most serious, however, is 
the omission of a Print command in the File menu, 1 had to 
write a program to print text files with pagination. This is a 
problem with all ST editors I have encountered. 

The whole package is tied together by an "executive" shell 
program from which the components can be called, either 
separately or in batch operations (such as assembling a source 
file and chaining directly to the linker with default options). 
Everything makes good, clean use of GEM elements, and as- 
sembling and linking speed are comparable to the Atari devel- 
oper's kit programs, if not belter. The option of using the 
assembler module as a TOS program without GEM overhead is 
a nice touch, enabling the use of batch file processing. Initially, 
however, the shell will provide a convenient programming 
environment. 

The assembler itself is complete and, like the rest of the 
package, well thought-out. Macros, conditional assembly, s)'m- 
bol table and cross-reference listings, and include files are all 
supported. Clearly this assembler was designed to support 
high-level languages — there is a COMMON directive that the 
manual connects to Fortran! The standard EQU, XREF, XDEF, 
DC, DCB, and DS pseudo-ops are available, as well as many 
others. The macro facility is extensive, including several 
"pseudo- functions" such as ,LEN and .INSTR that can be used 
in string substitutions, GST thoughtfully includes a library of 
useful macros for conditionals, loops, stack handling, and sub- 
routines. Assembler errors are all carefully documented, but 
TOS errors are not, (They are usually fatal anyway, the manual 
claims ) 

GST has done an excellent job of making assembly lan- 
guage development accessible to ST users. Let's hope they're 
working on a debugger of similar quality! 

METACOMCO 

Metacomco, an acclaimed s\'stem software developer in the 
68000 world, has done a good job with its ST Macro As- 
sembler package, k is the only package to provide an example 
source listing of a program that makes GEM calls, but like the 



others provides no real documentation, 

ED is Metacomco's standard, simple, full-screen TOS-based 
editor, and is similar to Micro EMACS. It is adequate for work- 
ing with assembly language source files, but takes some get- 
ting used to. It has some nice features, such as the ability to 
specify the text buffer's size and to continue executing a com- 
mand (such as search and replace) until an error condition 
arises. 

The assembler came closest of the four to functioning as a 
replacement for DRl's AS68, It has all the features of GST- 
ASM, plus local labels; but the macro facility is much weaker 
and no library of macros is provided. Strangely, two directives 
that do absolutely nothing are provided, yet there is no EVEN 
pseudo-op to make sure the following code begins at an even 
address. The manual documents the L1NK68 linker, which is 
not supplied on the enclosed disk. However, the instructions 
for assembling the sample programs (provided in printed form 
only — aargh!) apply only to UNK68 and reference libraries 
not included on the disk, GST-LINK and its manual, identical 
to that in the GST -ASM package, are included. Metacomco's 
manual is typeset and carefully indexed, but does not accu- 
rately reflect the contents of the disk. This is a vanilla pro- 
gram — I suppose it lives up to its claim of being "full 
specification" but it is not as complete as GST -ASM. (Of course 
it beats A-SEKA!) 

HISOFT DEVPACST 

HiSoft, a well-known European developer, was still working 
on their DevpacST in April 1986, I was furnished with a copy 
of version 0,99. (The final release is to be 1.00), Even so, the 
manual was bound and the packaging complete, DevpacST 
strikes a middle ground between the fast, loose, in-memory 
approach of A-SEKA and the formal edit-assemble-link para- 
digm of AS68, GST -ASM, and Metacomco's Macro Assembler 
Its editor and debugger are both window-based, but it does 
not provide a linker, 

EdST makes full use of GEM but provides only one text ed- 
iting wmdow. The amount of free memory and the current row 
and column are displayed at the window's top. On my 520ST 
with TOS in ROM, there were only about 60,000 free bytes — 
a small buffer when it is the only one you have to work vidth. 
For large programs the editor's restrictions could be severely 
limiting, EsST allows several methods of command entry in- 
cluding: drop-down menus, keyboard equivalents, and Word- 
Star-like equivalents. 

When you are ready to assemble your source file, you just 
choose the Assemble command (Alt-A) and a 2-pass assembly 
process occurs. The assembler supports the same standard fea- 
tures as the others, but the options for listing generation, mac- 
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ras, and conditional assembly are even more limited than 
Metacomco's. There is not much to say here except that the as- 
sembler still had a couple of serious bugs in version 0.99. The 
assembler and editor are only available from the GenST shell, 
and no linker is employed. 

The highlight of DevpacST is the MonST debugger. It uses 
Four non-GEM windows: 68000 register value display, hex- 
adecimal memory dump, disassembly (normally of instruc- 
tions near the Program Counter value), and command entry/ 
response. After loading MonST, you are prompted to enter the 
name of the program you want to work with, which is then 
loaded into memory. MonST preserves the program's screen 
and requires only about 12K of memory. MonST is automati- 
cally invoked whenever an exception occurs. You can set and 
clear breakpoints; single-step; view the program's screen; dis- 
assemble, search, examine, and modify memory; and modify 
the processor registers. This is a good first debugging tool. 



An assembler is 

not an intuitive program . . . you 

cannot usually "pick it up" as 

you go along. 



The short, 40-page manual is poorly written, even com- 
pared to A-SEKA's documentation. It needs expanding, rewrit- 
ling, and proofreading. One nice touch is a list of known bugs 
in version 0-90. HiSoft promises various improvements in ver- 
sion 1.00 of DevpacST, including bug fixes, GEM AES and 
VDI constant and macro definitions, source to a complete ap- 
plication (this would be revolutionary!), external references, 
and the ability to produce linkable object files. I cannot recom- 
mend the current version, but 1.00 should compare favorably 
with GST-ASM and Metacomco if HiSoft delivers on its prom- 
ises. Perhaps they will also index the manual . . . 

GST-LINK 

GST-LINK, which is included with GST-ASM, Metacomco's 
Macro Assembler, and other language products from both 
companies, supports an object file format that is fully docu- 
mented in the manual. It normally takes its input from a con- 
trol file specifying which files are to be linked in what order to 
form the executable program. The control file language in- 



cludes commands for setting the stack size, extracting mod- 
ules manually and automatically from library files, and 
defining new labels (useful for correcting typographical differ- 
ences between modules being linked). GST-LINK also pro- 
duces executable programs directly vvithout the annoyingly 
necessary RELMOD application used by LINK68. 

GST-LINK is becoming popular in ST software develop- 
ment and is generally superior to LINK68, found in the devel- 
oper's kit, but the incompatibility between the object file 
formats accepted by the two may cause problems. 

For the programmer who is selecting one and only one lan- 
guage development environment, the question of linker com- 
patibility is relatively unimportant. However, if you have any 
intention of combining languages, porting between develop- 
ment environments, or using standard libraries provided only 
as object files (for example, the LIBF Motorola fast floating- 
point library supplied by Atari in the developer's kit), the lack 
of a standard could complicate and retard ST development 
progress, I hke GST-LINK (although LINK68 and the Personal 
Pascal linker have been adequate for all my needs so far), but a 
standard format is needed. 

SUMMING IT UP 

1 recommend GST-ASM as the most professional and complete 
package, and as the best value. Metacomco's Macro Assembler 
is comparable and desirable for use with its other language 
products. DevPacST in its current version is unacceptable, al- 
though its debugger is useful and version LOO has potential. 
A-SEKA is woefully inadequate unless you want to learn 
68000 assembly language in an interactive environment. But if 
you already have Atari's developer's kit, you could safely stick 
with good old AS68 and LINK68 without falling behind the 
competition, 1 hope GST-EDIT is released separately for users 
who do not need the entire package. 

Documentation is one of the most important aspects of a 
language environment. Before purchasing any of these pack- 
ages, including the Atari developer's kit, carefully examine the 
documentation to make sure it provides you with enough in- 
formation to effectively use the product. An assembler is not 
an intuitive program like a GEM-based word processor — you 
cannot usually "pick it up" as you go along. Unfortunately, 
none of the packages include sufficient examples or informa- 
tion on accessing system routines for a programmer to get 
started without other sources. C source code is much more 
plentiful than assembler in the ST world, so you should be 
prepared to do some work before you begin programming. The 
rewards of a successful GEM program in fast 68000 assembly 
language will be well worth the effort! 
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LIST OF MANUFACTURERS 

Atari Corp., 1196 Borregas Avenue, P.O. Box 3427, 

Sunny\'ale, CA 94088-3427. (408) 745-2000 
Kuma Computers Ltd., 12 Horseshoe Park, Pangbourne, Berks 

RGB 7JW, United Kingdom, 07357 4335 
GST Holdings Ltd., 91 Right Street, Longstanton, Cambridge, 

England 
Metacomco, 26 Bristol Square, Bristol BS2 8RZ, United 

Kingdom 
HiSoft, 180 High Street North, Dunstable LU6 lAT, United 

Kingdom, 0582 696241 
The Kuma, GST, and Metacomco assemblers are available in 
The Catalog in this issue. 

REFERENCE: 

• intwducing 520ST Assembly Language by Christopher 
Chabris, Antic magazine, December 1985 

• Atari ST Internals by K, Gerits, L. Englisch, and R, 
Bruckmann, Abacus Software, Grand Rapids, Ml 

• Atari ST GEM Programmer's Reference by Norberr 
Szczepanowski and Bernd Gunrher, Abacus Software. Grand 
Rapids, Ml 

• Atari ST Machine Language by B. Grohmann, R Seidler, and 
H. Slibar, Abacus Software, Grand Rapids, MI 

■ COMPUTE'S ST Programnier's Guide by The Editors of 
COMPUTE!, COMPUTE! Books, Greensboro, NC 

• 68000 Microprocessor Handbook, 2nd ed., by William 
Cramer and Gerry Kane, Osborne/McGraw-Hill, Berkeley, 

CA 

• 68000, 60010, 68020 Primer by Stan Kelly-Bootle and Bob 
Fowler, Howard W Saras & Co., Indianapolis, IN 

• Mastering the 68000 Microprocessor by Phillip R, Robinson, 
Tab Books, Ridge Summit, PA ■ 

START is a magazine with its programs on disk. Nor- 
mally you will find the disk bound into the magazine and 
for sale on the newsstands at a combined price of $14.95. 

But we know that some of you ST enthusiasts want to 
read START first, without paying $14.95, so we have 
provided a limited number of copies without disk for 
$4.00 each. 

If this is your situation, you can complete your copy of 
this collector's issue of START by ordering the companion 
disk direct from us, for S10.95 plus $2.00 shipping and 
handling. See the handy order form . 



Software for 
the Atari 520Sr 



H&DBase 

Relational Database Management 
Language for the Atari 520ST® Computer 

H&DBase is a Relational Database Management Language 
which allows novice and expert users alike to manipulate any 
type of data through the use of straight-forward, English-like 
cornmands. 

For the novice, H&DBase is an interactive data storage and 
retrieval package suitable for maintainingphone directories, 
club rosters, genealogies and more. 

■ For experienced users, it is a system development package 
containing its own programming language. A skilled 
programmer can use H&D Base to create a system for handling 
inventories, accounts payable and receivable, client lists, and 
. other programs which would normally be written in more 
cumbersome languages. 

Regardless of the level of user expertise, H&DBase is the 
p^ec^/oo/for data management. 

PROGRAM HIGHLIGHTS: 

" Comprehensive Manual: Introduction, S!ai-ting-up. Thlorial, 
Rrfercnce. Appendices & Index Sections plus Reference Card 

• On-screen "Heip" System 

• Elementary' ^bit Editor 

• Powerful Report Generator with Saved Report Forms 

■ Sort on any Field to any Level 

• Full Math Capability on any Field or Vaiiable 

• Disk Based System: Only Sikp, Limitation is Disk Capacity 

• Compatible with most "dBASP-II"'*" Command Files 

• Compatible with all "SDF" and "Delimited" Data Files 

• Over 275 FORTf! Commands (including "calls" to the GEM® 
Interface - Atari "Dsueloptn-'s Kit" required ) 

• Add Voiir Own Commands 

• Create -Auto-run Applications 

" Includes Sample GEM Mailing Li.^t Program (written in 
H&DBase) 

• Run-time Developer's Package Available 

• Source 1-eve! Maintenance 

■ Not Copy Protected 
SUGGESTED UST PRICE: S99,95 

ALSO AVAILABLE FOR THE ATARI 520ST® : 

Ibolbox' Volume One - $39.95 - Five Invaluable Utilities 
H&D Forth - S49.95 - FORTH Programming language 

For information (800) 641-1441 

InCWornia,ca!h (800) 641-1442 
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iri4] liulldogl-ane.Suitcti 
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gives you the POWER with these 
STEMS products for the ST . . . 



PDWEBEDIT is a powerful and easy-to-use text editor. Edit up to 
20 files in from 1 to S windows. Move or copy data within a 
file or to a different file. Globai change, search, auto save, and 
much, much more. Documentation on disk, 44,95 



PowerAssist c 



detects and reports on abnormal termination of 
programs. Lists and/or prints register contents, memory con- 
tents, addresses, and a detailed error description. Errors may be 
corrected, and the program restarted or normally terminated. 
Documentation on disk, 29.95 



PowerVision pro. 



des NEOCHROIVIE slide presentation devel- 
opment capability, with special effects, and variable display, 
i.e., corner to corner, top to bottom, side to side, etc. Data 
lompression is performed, so 40 or more pictures may be stored 

24.95 



one disk. Documentation on disk, 
POWERHOUSE ,s = home;buslness f, 



al package which In- 
cludes ammortization schedules, present and future values, 
annuities and sinking funds, budgeting, simple and compound 
interest, checking account tracking, investment tracking and 
Documentation on disk, 29 95 



PowebWriter/multi-lingual i 



a word processing system 
with multi-lingual support, English, Russian, German, Hebrew, 
and more, including define your own. Documentation on disk. 

49.95 
— 75% Discount for ordering 2 or more different products — 
Send check or M.O,. or call collect for VISA/MC or COD orders. 
- WA. State Res, add appi, sales tax - 



43328 S.E. 176th 



North Bend,WA98D45 



1 Machl™ for the Atari ST 


Machl; multi-tasking Forih-83/GEM development system 

With everything you need to develop stand-alone applications, 
including: integrated GEM editor, full GEM and DOS support. 
Motorola assembler, examples, and our 300 page manual, 

Machl is interactive, so it allows you to experiment with the 
ST without going thru the compile-link-execute cycle. But 
when you do load in programs, look how we stack up: 




Sieve Compile Link Execute 

Machl 00.7 00.0 4.41 
Megamex C 70 24 3.83 
Hippo C 58.4 1:37 8.4 

C's w/o rsgittar variables 




Palo 

POB 

MenI 

800/^ 

415/£ 

Avail 


That's three times the execution speed of other Forth's 
^ote the turnaround time. It simply takes less time to 
develop your programs or finished products with Machl. 

all for only 

$59.95 

^(to Shipping 

3x7430 plusS5S/H 
Park, CA 94026 CA Res. add 6,5% 
4-FOBTH (SalesI VISA/MC COD 
54-2749 (Dev. Support) Qnginal Macintosh v 
ble July 15, 1986 (v1 .2) available for $ 


ersion 
49,95 



Now available for 

ATARI ST, AMIGA, APPLE, IBM 

ATARI«»«u«E. and COMMODORE 64/128 

THE MOST EFFECTIVE WAY TO 
LEARN TOUCH TYPING! 



TYPING TUTOR + 
WORD INVADERS 



Two great programs in one package. Learn to 
use your keyboard quickly and properly. 
TYPING TUTOR slarts with the 'home keys' 
and automatically evaluates your typing per- 
formance, introducing you to new keys in 
many gradual steps as your skills develop. WORD INVADERS 
puts real excitement into your touch typing practice while rein- 
forcing proper typing techniques. 

'This is the best typing tutor we have seen yet; *■*■**+" 
INFO-64 
"Best typing tutor I've seen -Better than Mastertype" 

Microcomputer Courseware Evaluation 
■■WORD INVADERS is fantastic- 
Editors of Consumer Guide 




ATARI ST 

AMIGA 

IBM PC, PCjr 

Disk $34,95 



APPLE He, He 
ATARI 800/XLs/XEs 
COMMODORE 64/128 
Disk $24.95 



SOFTL4//1RE 

P.O. Box 6277 San Rafael, CA 94903 (415) 499-0650 




YOUR 
PROGRAM 



IN SINGLE OR LARGE QUANTITIES, PROVIDES: 
•LOW COST, DISKLESS APPLICATIONS 
■PROGRAM COPY PROTECTION 
•DATA DURABILITY AND RELIABILITY 



10 1000 



TYPICAL 64K 
PRICING 128K 



$49 
$139 



$29 
$49 



CALL FOR 
QUOTE AND 
PROGRAM INFO 



ANSI VT100 CARTRIDGE 

FULL TERMINAL EMULATION WITH USER CONFIGURATION 
PLUG, DOES NOT REQUIRE DISK DRIVE, 



916-265-4668 ^^ 



• 12 month warranty • Free UPS 2ND DAY AIR 

■ Quantity discounts (Continental US) Hawaii add $3 



R MASTERCARO, Checks h 



I COMPUTER SYSTEMS 



408 BROAD ST 
NEVADA CITY, CA 95959 
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UNIX FOR THE ST 



MICRO C-SHELL 



BY RUSS WETMORE 



Micro C-Shell 

David Beckemeyer Development Tools 

592 Jean St. #304 

Oakland, CA 94610 

(415) 658-5318 

$49.95 



rhe GEM environment is an excellent computer interface, 
especially for the novice user. However, sometimes an in- 
terface sucfi as the GEM Desktop can be a hinderance. 
Programmers need more power than such a simple interface 
can support, and most t}'pes of utilities a developer needs are 
text oriented, not icon-based. 

Micro C-Shell is a type of program commonly called a 
"CLI " for Command Line Interpreter and presents the user 
with a more traditional interface for disk files management. It 
isn't necessarily easy to use (though it is easy to learn) or 
pretty on the eyes, but it is fast and can perform several differ- 
ent tasks with one command line. 

Micro C-Shell is based for the most part on a CLI written 
for Unix machines, called "csh," short for "C-Shell." It is called 
a shell because it acts like one, sitting over the normal operat- 
ing system interface. It provides the user with a powerful, uni- 
fied environment, 

Csh was developed at the computer science department of 
the University of California at Berkeley, The Berkeley group 
has a long-standing reputation for its innovative additions to 
Unix's functionality. (Unix, by the way, is an operating system 
developed at Bell Labs, widely used on mini- and micro-com- 
puters.) Although part of csh's allure is it's ease of use in 
muki-user environments, its power makes it perfectly viable 
on single-user machines. 



Beckemeyer's Micro C-Shell package also includes many 
useful utilities found on Unix systems. Non-programmers will 
find many of these utilities useful (such as the line/word/char- 
acter counter and file string search facilities) but it is the se- 
rious developer who will appreciate the added power these 
programs provide. 

Micro C-Shell doesn't use the GEM interface at all (except 
for an occasional error alert) and takes its input from the key- 
board. You enter commands at the Micro C-Shell prompt. The 
commands may either be "built-in" to the shell, or be separate 
utilities on the disk (with a .PRG extender). Micro C-Shell is 
provided with the commands and utilities described in the ac- 
companying sidebar. 

Some of these commands are separate programs loaded in 
by the shell - you can add whatever commands you like to 
Micro C-Shell just by adding new programs. Those listed here 
are only the ones supplied in the currently sold f 



/fall Micro C-Shell did was perform the commands listed 
above, it would be a great package. The more advanced 
features of the shell, however, are what make it especially 
valuable and powerful. 

Typically, Unix systems have three assigned, default "de-' 
vices" available to programs: 

Standard Input 
Standard Output 
Standard Error 

All three of these devices are normally set to the "console" de- 
vice - the monitor screen for output and the keyboard for in- 
put. However, a program can redirect these to any other 
supported device, Eor example, you can optionally send 
output normally intended for the screen to the printer, to a ► 
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disk file, or even to another program! (This is the subtle 
reason for the third device, the Standard Error device. This 
allows a program to send error or prompting messages to a 
device usually guaranteed to be the screen, even if the 
standard output is routed elsewhere. The standard error device 
can sometimes, however, be redirected just like the others - 
for example, if you'd like error messages sent to the printer 
instead.) 

Unix uses the analogy of "pipes" in dealing with data. The 
"flow" of information can be redirected to another location, 
"piped" to another program, and even sent two different ways 
at once using a "tee". 

Let's take an example. You want a directory listing sent to a 
disk file, instead of the screen, so that you can edit it into 
some documents. The standard directory command is: 

%ls 

(The "%" character is the standard Micro C-Shell prompt; you 
only would type the "Is" followed by a carriage return,) This 
prints a listing of all files and directories in the working direc- 
tory CO the standard output device, normally the monitor 
screen. In this case, you follow the command with a ">" char- 
acter, followed by the file you'd like the standard output sent 
to, as in: 

% Is >a:directry.txt 

Now, instead of the directory being printed on the screen, it 
will be written to a file on drive A called D1RECTRY.TXT You 
could, in turn, take the edited DIRECTRYTXT file and print it 
to the printer using the "Ipr" command. 

When you send the standard output to another program, 
that program must be a "filter." This is a program which takes 
some input, manipulates it in some way, then outputs the re- 
sult. Filters take their input either from a command line as a 
normal command, or from the standard input. Thus, when 
you send the standard output of one program to another, that 
data becomes the standard input for the next program, (Again, 
using the pipes analogy, this would resemble a filter in a pipe 
which removes dirt from a stream of water before passing the 
water on somewhere else.) 

With "pipes" we can reduce this process to one command. 
If we were to type the following command: 

% Is I Ipr 

the "I" character (ASCII 124) tells the shell that we want the 
standard output from the Is program sent (or "piped") as stan- 
dard input to the Ipr program. 

Piping can get quite involved, and if used correctly can per- 
form some powerful tasks. For example, the command 



MICRO C-SHELL COMMANDS 

alias Lets you define a sort of "macro" which replaces 
o given i<ey word. 

cat "Concatenates" (appends together) one or more 
disic files and prints them to the standard output device. 

cc A short cut for programmers using fhe C language 
compiler sold in the developer's kit from Atari. It allows 
you to run a C source file through alt of the various 
subprograms necessary to produce a linkable object 
file. 

cd Changes to a new "working" directory or sub- 
directory. It's like opening a folder with the Desktop 
program. 

chmod Allows you to change the "permissions" of 
files. You can make files "read only," "hidden" from 
directory searches, and designate "system" files. 

cmp Compores two disk files and tells you if they differ, 
and if so, the line number and byte position of the first 
difference. 

Cp Makes a copy of one or more disk files. 

date Allows you to change the reaf-ffme clock to a 
given date and time. 

df Tells you how much free space you have on a given 
disk. 

diff Compares two text files. If they differ, it can 

construct a script telling what lines must change In each 
file to make them equal. This script can be interpreted 
directly by fhe "see/" command, which will perform the 
necessary editing for you. This command is very useful 
far programmers - if you make a number of changes to 
a working source code file (and possibly forget 
everything you've changed) diff can tell you after the 
fact what those changes were. 

echo Echoes the "tail" (the words following a 

sequence: 

% grep -n register *.c [ pr -h "found register;" | Ipr 

does the following: 

1. finds each file in the working directory with a ",c" ex- 
tender (typical of C source files). 

2. in each file in turn, finds each hne which contains the 
word "register" (including the line numbers where they were 
found). 

3. formats the output into page size chunks with the 
phrase, "lound register:" at the top of each page. 

4. ships the whole kit'n'kaboodle to the printer, 

A "tee" sends output two different directions at once, much 
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command /7se/^ expanding all shell variables and 
wildcard file designators. 

fcp Does a track-hy-track copy of an entire disk. 

fmt Formats a disk. 

gem Assuming there is enough RAM left, this 
command allows you to directly run a GEM-based 
program from the shell prompt. This keeps you from 
exiting to the Desktop to run a CEM-based program. 

grep "grep" is shorthand for "Global Regular 

Expression Printer." It searches files for a string pattern. 
There are many different options, allowing you to 
search for a wide range of expressions. One common 
use for programmers is to find a label's occurence over 
a range of source code files. 

head Prints a given number of lines at the "head" or 
start of one or more text files. 

history A very powerful command, which tells you up 
to the last 16 commands that you have entered. These 
past commands can be referenced by number, or by 
name, and you can edit a past command. It lets you 
correct typing mistakes on long command lines, instead 
of typing the whole line again. It also lets you perform 
the same function over a range of files. 

logout Exits to whatever program loaded Micro C- 
Shell (normally the Desktop program). 

ipr This function is called a "filter" and prints one or 
more text files to the printer You can specify page 
length and width, and make the printer pause between 
pages for single sheet entry. 

Is list fhe contents of a directory. There are several 
options to this command, allowing for a wide range of 
directory formats. 

mkdir Makes a new directory or sub-directory. 

more Takes o text file and prints it out one screen at a 



time, pausing so that you can peruse the file at your 
leisure. You can also search for strings, backup to 
previous positions, and so on. 

mv Moves for renames) files. When you move a file 
from one directory to another, it deletes the original 
copy of the file so that only the destination copy exists. 
This is unlike the Desktop program, which only lets you 
copy a file to another drive or folder. When you 
"move" a file within the same directory, you are 
effectively renaming it. 

pr Prints one or more files to the standard output 
device, with or without an optional header line. 

pwd 7e//s you the present "working" directory (that is, 
the current default directory). 

rm Deletes one or more files from the disk. 

rmdir Deletes one or more directories from the disk, 
which must be emptied first. 

sed The "Stream EDitor." This program copies a file to 
the standard output device, using a script file (see diff) 
which sed uses to make on the fly editing changes 
while it's printing. This is a short cut method of loading 
a file manually into a text editor and keying in the 
changes yourself, diff can create such scripts, and sed 
in turn rounds out an automated editing process. 

set Allows you to set a shell variable. Some shell 
variables are used by the shell itself You can create 
your own variables to reference in command lines. 

tail Prints a given number of lines from the "tail" or end 
of one or more text files. 

tee tee copies a file from the standard input device to 
both a named file or device and fhe standard output 
device. 

wc Provides the number of words, lines, and/or 
characters in a text file. 



like its analogous "tee pipe fitting". 
For example: 

% Is -I I tee directry.txt 

sends a long directory listing to both the screen and the disk 
file called DIRECTRY.TXT in the working directory. Adding 
one more pipe, 

% Is -1 1 tee directry.txt | Ipr 

sends to both the disk file and the printer 

As mentioned above, you can create "aliases" for a string- 
This, in effect, extends the "language" of the shell. For exam- 
ple, let's say chat you have your working assembler source files 



in the following subdirectory: 

A: \ ASSEMBLRX SOURCES \ WORKING 

In Desktop terminology, this would be the folder WORKING, 
mside the folder SOURCES, inside the folder ASSEMBLR, on 
drive A. If all of your source files have an ".ASM" extender, 
you could get a long directory— listing filenames, sizes and 
modification dates — using the following command: 

% Is -1 a:\assemblr\sources\workmg\*. asm 

If you're going to be doing that a lot, though, it's a pain to type 
it every time. You could, instead, type: 

% alias asmdir Is -1 a; \assemblr\ sources \ working \*. asm 
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which makes "asmdir" a synonym of that long command line. 
From then on, every time you enter: 

% asmdir 

at the shell prompt, its alias is substituted in its place and you 

get the directory you're looking for. 

Micro C-Shell also maintains its own set of variables, 

which you can alter and add to. The following are defined by 

the system: 

$path A collection of pathnames. Whenever you type in a 
command, if it needs to be loaded, the shell looks in every 
directory in the Spath variable to find it. This helps keep 
you from having to know the location of every utility on 
every disk - the shell just keeps referring to $path until it 
finds what it's looking for or runs out of places to look. 

Sprompt The shell prompt. Normally a "%" character, you 
can change this to whatever you like, 

Sinclude, Stemp, Ssymb: These three are used by the cc 
command for use with the Alcyon C compiler and the AS68 
assembler, and describe the pathnames for C #include files, 
assembler temporary files, and where the AS68 symbol file 
can be found, respectively 

Shome The "home" directory If you jump around between 
directories a lot, but want to use one particularly as a 
"home base", you can easily set it by typing % cd Shome 

$cwd The current directory This variable can't be changed, 
but can be referenced like any other. 



Jl M icro C-Shell always remembers the last 16 commands 
■mI entered. The history command prints them out for 
■ ■ I you. You can refer to any of these commands, and ex- 
ecute them again, by typing "!" followed by the command's 
history number, as in: 

% history 
lis -1 

2 cd tools 

3 history 
% !1 

executes the command "Is -1" again. You can also refer to pre- 
vious commands by strmgs; that is: 

% !ls 

given the above history would do the same thing. (The shell 
looks backv/ards through the list until it finds one that begins 
with the string you've given, executing the first one it finds.) 
You can refer to the immediately preceding command by 
typmg: 



and by referring to a previous command by its offset as a 
negative value from the current history number. So, above, 
we're at history number 4 at the second prompt, and typing: 

% !-3 

would also execute the "Is -1" command. 

Another powerful feature is the ability to edit previous com- 
mands. Let's say that you want a directory and type: 

% Is -1 a:\assemblr\sources\workjng\*. asm 

Oops! The third subdirectory is supposed to be "working" in- 
stead of "workjng", and the shell tells you it can't find what 
you've asked. Instead of retyping the whole line, just to correct 
one error, you can type: 

% ^workjng^working 

which repeats the preceding word again. 

There are other ways to edit previous commands, and 
you're not limited to just the most recently typed. For example; 

% !10:gs/tmp/temp 

executes the command with history number 10, substitutmg 
all occurances of "tmp" with "temp." 

The Micro C-Shell disk comes with a new "standard I/O" li- 
brary for Alcyon C programmers- This library fixes many of 
the problems with the libraries supplied by Atari, and is also 
faster and smaller 

The manual, though brief, is good. It is split into two parts: 
the first half is a short tutorial for newcomers, and the second 
half is a reference manual describing each of the commands in 
turn. 

This package has its faults. It could definitely use more doc- 
umentation. Some of the commands don't work as advertised 
in the manual, and indeed, some aren't documented at all. 

In general, though, Micro C-Shell is worth every penny, es- 
pecially if you're a developer. It has saved me hours of hassle, 
and I find more innovative ways to use it every day. 1 recom- 
mend it without hesitation. 

REFERENCE: 

• A User Guide to the Unix system by R, Thomas and Jean 
Yates, OSBORNE/McGraw-Hill, Berkeley, CA. 

• Introducing the Unix system by H. McGilton and Rachel 
Morgan, BYTE/McGraw-Hill, New York, NY 

■ The Unix Programming Environment by B.W. Kernighan and 
Rob Pike, Prentice-Hall, Englewood Cliffs, NJ. ■ 
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"ooks about the ST are essential for 
the serious programmer, and fortunately, 
considering the ST's newness, a number 
of them are available. Unfortunately, 
some were rushed to market and are not 
as complete or accurate as they should 
be. Nevertheless, several are respectable 
sources of technical information that 
will significantly shorten the time you 
spend getting up to speed on the ST, 

Probably the best and most useful 
volume out so far is Atari ST Internals, 
$19,95, one of a series of ST books pub- 
lished in the U.S, by Abacus Software, 
P.O. Box 7219, Grand Rapids, Ml 49510 
(616/241-5510), ST Internals includes 
information about the 68000 processor 
and how it is used in the ST (including 
instruction set and addressing modes), 
the ST's custom chips, the disk control- 
ler, and many other I/O situations. It de- 
scribes GEMDOS and has a complete 
listing of BIOS, the interface between 
GEMDOS and the hardware of the 
computer. 

The ST found an early and avid fol- 
lowing in Germany, and that's why ST 
Internals, like all of the Abacus ST 
books, was written in German (for Data 
Becker GmbH), then translated into 
English for the Abacus edition. The 
translation is very readable, but many 
typos have slipped in, raising some con- 
cern about the accuracy of technical in- 
formation. But again, there is so much 
good information here you can't afford 
not to have It, 

The next most important Abacus 
book is the Atari GEM Programmer's 
Reference, $19.95, As the title suggests, 



it is a reasonably complete guide to 
GEM, and the best thing you can get 
this side of the development documenta- 
tion. Of course, if you want the full doc- 
umentation, it costs $300 from Atari 
Corp, This includes 1,500 binder pages 
from Atari and Digital Research, Inc, 
designers of the GEM environment. Your 
$300 also buys six disks that contain 
the Alcyon C Compiler and Linkei" from 
DRI, a resource construction set, 
"DOODLE" (an application that explains 
and exercises GEM), plus tools and 
debuggers. The devoted programmer 
willing to pony up this much cash 
should order the ST Developer's Kit from 
Atari Corp,, 1196 Borregas Avenue, 
Sunnyvale, CA 94088. 

There are nine other Abacus titles for 
the ST, of varying interest and impor- 
tance. Atari ST Tricks and Tips, $19,95, 
concentrates on utilities and cookbook 
effects, especially from ST Basic, ST 
Graphics and Sound, $19,95, and ST 
Peeks and Pokes, $16,95, also look very 
helpful. Several on the Abacus list do 
not merit our recommendation. Present- 
ing (he Atari ST, $16.95, is too super- 
ficial to be of value, especially if you 
have the better books of the series. Atari 
ST for Beginners, $16.95, is really for 
beginners. Atari ST Logo, $19,95, is a 
waste due to the relative inadequacy of 
ST Logo. There is an ST Basic Training 
Guide, $16,95, and an ST Basic to C, 
$19.95, which we have not seen. 

One Abacus ST book. Atari ST Ma- 
chine Language, $19,95, is an acceptable 
introduction to this important topic, and 
offers the reader instructive assembly 
listings for the ST. But any programmer 
serious about AL will want to have 
68000 Assembly Language Programming, 
$19,95, from Osborne/McGraw Hill, 
This book by Lance Leventhal, et al,, is 
the bible for working with the 68000 
chip and is widely available at technical 
book stores. 



Another Osborne/McGraw Hill title is 
The Atari ST User's Guide, $15,95, by 
John Heilborn, who helped write Atari's 
ST documentation. His book is well il- 
lustrated for the beginner or others un- 
familiar with the iconic desktop, but it 
focuses on Logo, which is not the lan- 
guage of choice for many ST users. 

Two books by COMPUTE! Publica- 
tions deserve mention. The Elementary 
Atari ST, $16,95, by William B, Sanders 
is an introduction to the machine, ST 
Basic, sound and graphics, files and 1/0, 
Logo and Forth. Not nearly as detailed 
as ST Internals, it is still probably a bet- 
ter introduction than Presenting the 
Atari ST COMPUTE'.'s ST Programmer's 
Guide, $16.95, by the editors of COM- 
PUTE! deals primarily with ST Basic 
and ST Logo, and for those languages it 
is a useful handbook. 

Many other languages are available 
for the ST, and more arc coming. Interest 
in the several implementations of C for 
the ST is growing, for which we recom- 
mend Prentice- Hall's book The C Pro- 
gramming Language, $24,95, by 
Kernighan and Ritchie, who developed 
the language. Other C books include 
The C Primer, $17.95, by Hancock and 
Krieger (a Byte Book), and Learning to 
Program in C, $25.00, by Thomas Plum, 
published by Plum Hall Inc., 1 Spruce 
Ave,, Cardiff, NJ 08232, 

Pascal is also quite popular, and in 
that area the UCSD Pascal Handbook, 
$18,95, is available from Prentice- Hall, 
Englewood Cliffs, NJ, or from Tecan 
Software Systems, 1410 39th St., 
Brooklyn, NY 11218, Tecan is also the 
source for a complete Pascal package for 
the ST, $79.95, which includes the lan- 
guage in software, plus the extensive and 
definitive p-System documentation sup- 
porting UCSD Pascal. ■ 
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ATARI 520 ST 
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• COLOR MONITOR 

• 360 K DISK DRIVE 

• BUILT IN T05 

• 512 K KEYBOARD 

• 8 DIFFERENT 
SOFTWARE TITLES 
ST SOFTWARE 



FLIGHT 

SIMULATOR 29.99 

JET 29.99 

MINEWHEEL 24.99 

MUSIC STUDIO 29,99 

STRIP POKER 24.99 

BRIDGE 40 24.99 

FINANCIAL 

COOKBOOK 39.99 



HOW TO ORDER; CASHIER CHECK, MONEY ORDER, MASTER- 
CARDtor VISA- (Add 4% for charge cords),.. NO PERSONAL 
CHECKS. .NO CO.D.'s.. .SHIPPED U.P.S. PRICES SUBJECT TO 
CHANGE. 
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Software Tools 

Unlx™-like Utilities for the Atari ST 
MICRO C-Shell $49.95 

Unix-like C shell with many Unix-like 
Utilities included. Aliases, history, 
I/O redirection, pipes, shell variables, 
wildcards, C-like command scripts. 

MICRO Make $34.95 

Unix-like software maintenance utility. 



Multitasking Software! 

MT C-Shell $129.95 

Fully Multitasking C-Shell with job control and 
builtin line printer spooler. 

MICRO RTX $69.95 

Real-time multitasking OS. TOS compatibility! 
Process control, communication, time-slicing. 
MT C-Shell $99.95 until August 31, 19861 

Beckemeyer Development Tools 

592 Jean Street #304 

Oakland, CA 94610 

Telephone: 415/658-5318 
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ELECTRONIC OFFICE 
MAIL i COMPUTER 



A COMPLETE Communications System 



Now you can tap any of the countless 
telephone data based INFO sources. 
EXTRACT and FILE that data away for 
use later. Suddenly, your computer is 
the smartest terminal around because 
INTELLICOM emulates such ter- 
minals as: 

• Digital VT52/VT100 

• TeleVideo 910 ■ ADM3 A/5 

• ADDS Viewpoint/25 

• CompuServe Executive 

• TeleVideo 925 

Now you can transfer both binary and 
text files, using simple ASCII, ASCII 
Capture, Xon/Xoff, XMODEM {both 
Checksum and CRC are supported), 



KERMIT or CompuServe A Protocols. 
Operate at any speed up to 9600 baud 
without ever being outdated as higher 
speed/lower priced modems are 
introduced. 

Simple menu selections, with a built in 
HELP facility keep it easy forever. 
Autodial directories and auto login are 
supported along with simultaneous 
printing. 

Additional features: Variable Buffer 
Size reduces disk activity, while 
utilizing RAM capacity. Customizing 
utility program included to ease instal- 
lation and use. Persistence feature for 
autodialing and auto login. 



Auto login script files can be used to 
support almost any smart modem and/or 
automatically log into your favorite 
remote system. User defined ftmction 
keys. Color support. Remote access. 

Best of all, the entire versatile 
INTELLICOM package costs you 
only $69.95. K)R 'i'OUR 520 ST!I 

INTELLICOM is currently being used 
by ARMCO Steel, General Motors, 
Smithsonian Institute and countless 
other large corporations and government 
agencies worldwide. INTELLICOM is 
also available for use on IBM PC, Jr., 
AT and other true IBM compatibles as 
well as the Sanyo 550 series. 



DON'T DELAY! 

ORDER TODAY! 
RETURN UPS SHIPMENT 
GUARANTEED! HURRY! 




MaslerCard/VISA/COD orders accep 
Specify computer and DOS version wh 
ordering. Connecticut residents add 7 
tax Add S5 shipping for ail orders. 



INCLUDES FREE 

SUBSCRIPTION TO 

OFFICIAL AIRLINES 

GUIDES 

SAVE $50.00! 
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1325 East Main Street, Waterbury, CT 06705 
In Connecticut call: 597-0273 
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$49.95 
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What Sidekick did for the IBM, Cornerman does better for 
your Atari ST! This utility gives you a host of useful 
desk-top tools in one simple, neat package. With every- 
thing from a built in clock to a full function calculator, a 
cluttered desk is a thing of the past. And as a Desktop 
Accessory, Cornerman is a available nearly anywhere 
within GEM. 

■ RFAL-TIME CLOCK in digital or analog form. 

■ NOTEPAD lets you write and store notes for handy 
future reference and reminders. 

■ ASCII TABLE shows the ST's symbols with their 
decim;il & hex values. Great for programmers! 

■ PHONE BOOK stores all your important names & 
numbers, dials through your modem and even records 
elapsed calling time! 

■ 16 DIGIT CALCULATOR: works in binary, octal, 
decimal, and hex; 3 memory registers; math and logic 
functions; base conversions; "tape" printer output. 

■ DOS WINDOW for easy access to MichTron's Dos 
Shell program. 

■ 15-SQUARES GAME simply for entertainment. 

■ Doesn't interfere with other programs. 



MICHTRON UTILITIES 



$59.95 



What would a utility be worth that could turn back time 
and end frustration? Before you find out the hard way that 
such a udlity would be priceless, prepare yourself with 
MichTron Utilities. This utility searches for and retrieves 
deleted files and lost data. Change file contents, attributes, 
file and volume names, or any individual bytes on disk! 
Just type the new data or click on selector buttons. You 
can also format individual disk tracks and copy individual 
sectors to repair damaged disks. A new 10 sector format 
utility lets you add SDK of storage capacity to you disks. 



Personal Money Manager $49.95 

This personal accountant will keep accurate totals for as 
many expenses, income sources and accounts as you need. 
Print checks and other kinds of reports for a true picture of 
your current financial status. You can form projected bud- 
gets for future expenses and income. Fast and powerful, 
the Money Manager uses the GEM system for simplicity. 




UTILITIES 



THE ANIMATOR {$39.95} ■ Animate Neo or Degas 
pictures for business presentations, or just for fun. 

BBS ($49.95) - Complete Bulletin Board System 

BUSINESS TOOLS ($49.95) - Over 200 attorney- 
prepared business forms, letters, and contracts. 

CALENDAR ($29.95) - Desktop appointment calendar. 

DI'.T. ($49.95) - Transfer files between die ST and IBM. 

DOS SHELL ($39.95) - Mimics the MS-DOS command 
structure: "global" commands, batch files, and more. 

ECHO ($39.95) - Uses X-10 modules for a wireless 
remote-control system for home or office 

Introduction To LOGO ($49.95) - Easy tutorial lets you 
learn to program in Logo. 

KISSED ($39.95) - Debugger features full-screen editing, 
miniassembler/disassembler, help function and more. 

M-DISK ($39.95) - RAM-disk emulator gives you the 
equivalent power of an extra disk drive! 

MI-DUPE II ($39.95) - Fast, easy file duplication. 

MI'TERM ($49.95) - Advanced communicadon program 
lets your ST talk to virtually any other system. 

MIGHTY M.ML ($49.95) - Complete mailing-list mana- 
ger features multi-level sorts and conditional "flags" for 
specialized reports. 

SOFT-SPOOL ($49.95) - Frees your ST to print & 
compute at the same time. 

ARCADE GAMES: 

GOLD RUNNER ($39.95) - Infiltrate enemy gold mines. 

63 screens lest your skill and logic (color monitor). 
MAJOR MOTION ($39,95) - Race down the highway, 

destroying enemy spies as you gain new weapons and 

defenses (color monitor). 
MISSION MOUSE ($39.95) - Avoid the prowling cats as 

you climb to the next goal (monochrome monitor). 
TIME BANDIT ($39.95) - Collect the Treasures of Time! 

Choose from a multitude of worlds: 13 unique arcade 

lands and 3 complete arcade/ adventures (color monitor). 

STRATEGY GAMES: 

FLIP SIDE ($39.95) - Play Reversi against live or 

computer foes. 
CARDS ($39.95) - Blackjack, Cribbage, Klondike, Poker 

Squares, and SoUiaire (medium or high res only). 



All reasonably priced, with more coming every day. Ask for our latest catalog.' 

Dealer inquiries welcome • Visa and Mastercard accepted • Add S3.00 shipping and handling to each order, 

576 S. Telegraph, Pontiac, MI 48053 
Orders AND Information (313) 334-5700 
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e ore actively 
seeking new software for 
worldwide distribution. 



YOUR SUPPORT AND OUR COM- 
MITMENT TO GUARANTEED SATIS- 
FACTION, HAS MADE THIS THE 
MOST TALKED ABOUT CATALOG 
FOR ATARI USERS. 



WE PUT YOU FIRST in every decision we make. You 
wanted to be the first to have up to the minute news, 
information and innovative software ... We delivered 
a catalog with your Antic magazine. Antic made sure 
you were the firST to get ST software . . . with a spe- 
cial ST section in the magazine. We listened to you 
when you asked for more ways to be in contact with 
our customer service and technical team. Thanks to 
you we have been able to expand our ANTIC ON 
LINE through CompuServe and open our telephone 
lines five days a week 8:00 AM through 1:00 PM 
Pacific time. 

At Antic our customers come first. To make sure 
that you get first rate customer service we have listed 
a few helpful guidelines: 

TO ORDER: Call Toll Free (800) 443-0100 ext. 133. 

This number has been dedicated to order taking 

only. When ordering please refer to the product 

code (e.g. ST0202) listed with each product. 

HBH VISA and iAH MasterCard accepted. 



CUSTOMER SERVICE: Write or call: 

Antic Customer Service 

524 Second St. 

San Francisco, CA 94107 

(415) 957-0886 M-F 8AM-IPM Pacific time 
Please include your name, address, daytime phone and 
a clear explanation of your inquiry. For technical ques- 
tions be sure to include hardware configuration infor- 
mation. 

Retain all receipts and record method of payment. 
FOREIGNAND ALASKA: Please call or write 

our corporate headquarters listed above in the cus- 
tomer service section. 

n Check shipping and handling charges on the 

order form. 
COMPUSERVE: Log on to ANTIC ONLINE- 

type GO ANTIC 

□ New Product Information 
D BBCS Sysop Corner 

□ Customer Service 

n Ordering Information 
n Antic Catalog Service 



Thanks to you we're able to provide better service and deliver Atari XL/XE and 520 ST software at the best 
value possible. We're only a phone call away. Call us today. 



UNCONDITIONAL 
GUARANTEE OF 
COMPLETE 
SATISFACTION 

We unconditionally guarantee 
every product we sell to be free of 
defects and to operate properly. If 
you are not completely satisfied, or 
if any item Is defective, just contact 
our customer service department by 
mail, or phone, 'within 30 days of re- 
ceipt of merchandise to arrange for 
a prompt replacement. Only returns 
in new condition, with the original 
packaging materials will be ac- 
cepted. 



UPGRADE POLICY 

All Antic APX Classics programs are 
backed by an excellent upgrade 
policy. Just send in your current 
original program disk with proof of 
purchase and specify the revision 
you want. 

We will copy the new version 
directly onto the original disk. 
Please include a $5.00 upgrade and 
handling fee and send it to Antic 
Catalog Upgrades~-Customer Serv- 
ice Department. 



PRODUa WARRANTY 

Antic Publishing, Inc. warrants that 
the products sold in this catalog will 
operate properly and be free of 
defects for a period of 30 days. 
Should you require warranty serv- 
ice, assistance or information, 
contact: 

Antic Customer Service 

Antic Publishing 

524 Second St. 

Son Francisco, CA 94107 

(415)957-0886 
NOTE: You must send your warranty 
card to Antic to be covered by this 
warranty. 
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rom starships to solar sys- 
tems, skyscrapers to your 
L~-^ front stoop. Create and ani- 
H mate views of your own 3-D 

f^ '. objects. And no keyboarding 
here-CAD-3D is entirely GEM-based. 
It's got to be seen to be believed. 
DESIGNERS: Visualize ideas instantly— 
speeds up design process, 
DOODLERS: Relax with true creativ- 
ity. Save images for later 
use or alter them with 
any popular ST paint 
program. 

CAD-3D features include: 

D Works with monochrome or color 
monitor. Monochrome mode gives 16 
levels of shading, color gives choice of 
1 color /15 shades or 2 colors/7 s 
each. 



D View objects in see-thru or hidden 
wireframe form or solid form with 
true light shading. Change object 
form with one mouse click. 

D Three independent user-defined light 
sources plus ambient lighting. 

D Built-in 3D primitives (cubes, spheres, 
toroids). 

D Assemble up to twenty 3D objects 
into a scene and view from any per- 
spective. 

□ "Glue" objects together to create 
more complex objects. 

D Create radially symmetrical objects 
or expand 2D shapes into 3D shapes 
with one simple operation. 

D Animation capability— "record" view 
sequences for viewing with separate 
display program (included). 

D Spin and Extrude functions allow 
even the novice 3D experimenter to 



create a wide variety of beautiful 

shapes. 
□ Independent scaling and rotation of 

objects or groups of objects. 
D "Camera View" includes zoom lens 

and variable perspective. 
D GEM user interface allows use of 

four views at once, or one large view. 

Four-view mode is user-definable. 
n Saves completed images in DEGAS, 

Neochrome or COLR Object Editor 

format. 
n Print your objects with a graphics 

printer. 
n Detailed printed user manual. 

Requires TOS In ROM 

ST0214 $49.95 

Available May 15. 
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by Joe Chiazzese and Alan Page 



"FLASH is the only 
telecommmications 
program I use" 

— Ron Luks, 
Founder of 
CompuServe's 
SIG'Atariand 
Atari Developers 
Forum. 




verybody knows that Antic 
is passionately involved in 
telecommunications. For 
the ST, we searched tor the 
finest possible terminal pro- 
gram. The best we had seen in other 
fields was Crosstalk''" on the IBM and 
Smartcomm™ on the Mac. We wanted 
something better. It had to be something 
that would reduce the most complex 
telecom problems to one mouse-click. 

Good news. We found it. 

. . .And tt uses GEM. 

FLASH goes far beyond any communi- 
cations software currently offered for 
any computer. Here is a sampling (a very 
small sampling)of what you can count on 
from this extraordinary— PROGRAfVl- 
MABLE— terminal program. 

D Hassle-free, GEM-based memo EDI- 
TOR. Use your mouse or cursor keys 
(features block move, undo, search, 
merge files, and more). 

n FLASH allows you to scroti back and 
forth at high speed to review your ses- 
sion—edit it, print it, send it. or save 
it to disk. 

p FLASH command Language (FLASH 
COL) to automate log-ons, file trans- 
fers, and unattended operations. 



FREE OFFER! 

Here's what you get on CompuServe 

(with no surcharge) if you own an Atari 

ST 

ANTIC ONLINE 

Get your technical questions answered 
by Tim Oren. Originally with Digital 
Research, Tim wrote the GEM Resource 
Construction Set. 

Read two new chapters a month of 
Tim Orens PRO'GEM tutorial. Available 
exclusively on-line. 

ATARI 16-BIT FORUM 

All of the best ST public domain 
programs. Gossip with ST users and 
programmers from Great Britain to Aus- 
tralia. Even reach the authors of FLASH 
in Canada. 

ATARI DEVELOPERS 
FORUM 

Developers drop in daily to find out 
about the latest tools and talk of the 
trade. Includes the ANTIC ON-LINE 
SOFTWARE SIG. 



n VTIOO keypad editing emulation (fuff 
24 line x SO character display). 

Q CompuServe Vidtex high-resolution 
graphics terminal emulation. Save 
Vidtex graphics as DEGAS files and 
modify or print them out. 

n Supports Xmodem (CRC) and ASCI! 
TEXT protocols. 

n Extensive DOS functions at your 
fingertips. Two clocks: Built-in real- 
time system clock and elapsed timer. 

n 20 editable function keys. Chain them 
together u.sing FLASHCOL, creating 
totally automated macros. 

D Translation tables can independently 
filter any incoming or outgoing char- 
acters. Configure your ST to act like 
any other micro, terminal, or even 
mainframes. Plus, use filters to create 
your own secret codes and encrypt 
files. 

D High-res flip flop between 24 and 48 
lines in monochrome, 

□ Printed manual by Ian Chadwick. 



$39.95 




VIDTEX ONLINE 
GRAPHICS 

Digitized pictures of Hollywood stars, 
FBI 10 most wanted list, weather maps. 
and the new Antic On-Line Art Gallery. 
With Antic, on CompuServe, you can 
step into the future of telecommuni- 
cations. 



II 

FRANCE 

An Expert Systems 
Package For Your ST 

® 

EXPERT 
OPINION 



ARTIFICIAL INTELLIGENCE 




ANTIC WANTS YOU! 
PUBLISHING OFFER. 

A New Opportunity. 

Antic is looking for people to create use- 
ful knowledge bases using EXPERT 
OPINION. If you're an expert on a 
subject (any subject), get EXPERT 
OPINION—write a knowledge base 
. . .And Hit's very good, and has broad 
appeal, we'll publish it for you in this 
catalog. Write to me, Catalog Product 
Manager, for more details (my address 
is on the back page). Givemeyour expert 
opinions. I'll try to help you publish some 
of your knowledge bases on a commer- 
cial basis. 



EXPELRT OPINION and your expertise can turn your 
computer into an expert on any subject. 
EXPERT OPINION is a full-featured expert sys- 
tem for the Atari ST. (Note: Expert systems are 
powerful, intelligent programs. They use a reasoning process 
to develop quick, pragmatic answers for a wide range of com- 
plex problems currently requiring human expertise.) Currently, 
expert systems are used in the fields of medicine, economics, 
and geological surveying. 

WITH THE MANUAL PROVIDED AND SUGGESTED SUPPLE- 
MENTARY READING MATERIAL, YOU CAN BUILD YOUR 
OWN KNOWLEDGE BASE-EXPERT OPINION DOES THE 
REST 

OnceyouVebuilt your knowledge base, EXPERTOPINION is 
easy-to-use because it's based on a powerful natural language 
interface, so you can give your input— and get your answers 
in plain English. EXPERT OPINION can explain how it arrived 
at a particuItU" conclusion by listing the rules used. Plus, it is the 
only expert system presently available for micro-computers 
which can clearly explain why a particular question is being 
Eisked (it backtracks up to 10 levels). 



ORDER NOW! FREE BONUS! 

TWO QUICK-START EXAMPLES: 

Finance Knowledge Base— 30 rules 
Palmistry Knowledge Base— 150 rules. 

ST0219 



EXPERT OPINION offers more ways to solve a problem than 

any other expert system: 

n DEDUCTION— Use this mode if you have some initial data 

about the problem (also known as Forward Chaining). 
D VERIFICATION OF A HYPOTHESIS-Your computer 

asks you questions about your hypothesis (eiIso known as 

Backward Chaining). 
n EXPERTISE (totally new technique)- A combination of the 

above, for situations where you have no initial data about 

the problem, and no hypothesis (Mixed Chaining Mode). 

EXPERTOPINION features: 

D Dictionary linked to each knowledge base. 

n Unlimited number of knowledge bases. 

n Extensive printed manual includes: How To Use an Expert 
System. How to Construct a Knowledge Base, plus a 
"Theory" chapter, Glossary, Bibliography, and more. 

□ User-friendly command structure and [Help] functions for 
simple usage. 

WARNING: This is a sophisticated computer science tool requir- 
ing study to use it effectively. We recommend the following 
books to help you use the program to its fullest: 
THE COGNITIVE COMPUTER, Addison Wesley 1984 
EXPERT SYSTEMS, Wiley Press 1985 
INTRODUCTION TO ARTIFICIAL INTELLIGENCE, 
Addison Wesley 1985 



From 

Mind Soft, 
France 




TOLL 
FREE 



, Credit card holders, call toll-free, 24 hours-a-day 

S 800-443-0100, eXt. 133 IContinental us and Hawaii) 4 
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Written for the Atari ST 

by Harry Koons and David Chenetle 

Put yourself anywhere in the 
world — even your own 
hometown. And now view 
that land mass from any al- 
titude—in full perspective! 
Design a wide variety of maps with your 
Atari ST, then print them out on a graph- 
ics printer. 

Using advanced CAD system algorithms, 
MAPS and LEGENDS takes less than a 
minute to do what used to take hours for 
computers— and weeks by hand. It fea- 
tures ultra-fast drawing of world maps 
from one of 11 perspectives, three reso- 
lutions, up to 16 colors. 

ENTIRELY GEM-BASED 
FEATURES INCLUDE: 

D DRAWING TOOLS 

• Multiple Patterns 

• Variable Size Pen and Eraser 

• Text (3 sizes, includes Antic's 
Font Accessory and over a 
dozen fonts) 






ioess. 



ftosvi 



• Fills (both solid and patterned) 

• Make any size maps using 
window sliders and size button. 
Put up to 10 different maps and 
perspectives on one screen! 

D OPTIONS MENU: 

• TEXT Mode (place labels 
anywhere) 

• LOCATE Mode: Reads geo- 
graphic coordinates from map, 
and distance and bearing from 
any point on the Earth. 

• STATE BOUNDARIES (for U.S. 
maps) 

• GRATICULE Mode (variable-size 
grid) 

□ DEGAS and Neo compatible. Use your 
maps as basic elements in the most 
popular ST graphics packages. 

D Works with color and monochrome 
systems. 

n EDUCATIONAL AND 
PRACTICAL: 

• For Educators from K thru 12, 
and university levels too. Teach 
your children to recognize land 



masses, oceans, other points of 
interest. 

• Next time you go on a trip, 
make a map to go with your 
itinerary. (Very impressive). 

• Complete documentation 
reference file (includes: 
glossary, bibliography, and 
technical notes). 



ST0202 



$34.95 



NOTE: When we first saw this program 
at Antic, we were impressed. It performs 
functions usually found on cartography 
systems that cost $700 and up (plus, it's 
OEM-based, so anyone can use it). After 
it was in the office for a few weeks, ev- 
eryone began making maps, The edito- 
rial, art, circulation, marketing and ac- 
counting departments al! found creative 
uses for it and everyone loved it because 
it was so much fun. So, we decided that 
it should be in the catalog, but we couldn't 
decide on the price. We settled on $34.95, 
with a huge documentation file on the 
disk, because everyone ought to be able 
to afford a copy. 
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FINALLY! GEM DEVELOPMENT AND LEARNING TOOLS AT A SUPER VALUE! 




UNITED KINGDOM 



A-SEKA" by Kuma 

(68000 Assembler, Editor, Debugger) 



When you want it NOW. 
A-SEKA-ForSpeed. 

By Andelos Systems /Kuma, UK 



Sometimes you just need to get that 
code running faster. A high-level 
language application needs a burst 
of energy. Or maybe it's arcade 
action — high end stuff. A-SEK A does 
ltAisf,becauseiti8allinRAM.Allof 
it: The Assembler, Editor and Moni- 
tor/Debugger. Those who know 
how can create exciting codes 
mighty fast. And if you're learning 
Assembly, you won't ever have to 
wait for your latest attempt to go 
through the assemble and link 
process. 



A-SEKA assembles source codes at over 
30,000 lines per minute! And since It can 
assemble and link simultaneously, you 
can run your code instantly. 01 course, 
A-SEKA is also a macro assembler and 
uses standard Motorola mnemonics. But 
what really sets it apart is its powerful 
machine language monitor, disassembler 
and symbolic debugger 

DEBUGGER FEATURES: 

• Symbol table access. 

• Arithmetic operations. Input in 
any base. 

• Disassembles 16 lines at a time. 

• Motorola mnemonics. 

• Single step. Trace. 

• Multiple breakpoints. Memory 
inspect and modify. 

• Line assembler. 

• Examine registers, 



AND MORE... 

All this, for under $35! You're probably 
saying to yourself, "Sounds great, but 
what's the catch?" OK, here it is. RAM- 
based assemblers can only assemble pro- 
grams which are small enough to fit into 
the edit and code buffers of random ac- 
cess memory at the same time. On theST, 
that's quite large, but there will always be 
a limit (there is no size limit for our other 
assemblers). 



ST0216 



$34.95 



NOTE: In arecent product review in Page 
6', the original British magazine for Atari 
users, the reviewer said, "A-SEKA is most 
useful to the programmer interested in 
learning 68000 assembler. It provides 
everything you will need. . ." 



A-RAM™ by Kuma 



*■ Take a look at our RAMdisk . 
^ (Random Access Memory 
^ disk emulator) 
It^ a remarkable value. 

By Roddy Pratt. UK 



Can your RAMdisk partition any size 

disk emulator you want? 

N- A-RAM can. 

Can it work with TOS in ROM? 

^ A-RAM can. 

Can your RAMdisk accelerate your 

floppy write speed by turning off the 

verify mode? 

>■ A-RAM can. 

Can you have multiple RAMdisks 

present at the same time? 

^ You guessed it. A-RAM can. 



A RAMdisk is an area of memory set 
aside as a buffer that responds to most of 
the available disk commands— only 
much faster. Everybody needs a great 
RAMdisk, and A-RAM is powerful, 
simple and flexible enough for every 
application. 

ST0215 S19.95 



TOLL 
FREE 



Credit card liolders, call toll-free, 24 hours~a-day orders 

£1800-443-0100, eXt. 133 IContlnental us and Hawaii) M °'^^^' 
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GST C" Compiter ^1^ 



UNITED KINGDOM 



*■ Here is the compiler fhiat 
. 1ST WORD was written in. 

•■ Do you want to write GEM-based 
programs for the Atari ST? With 

*" GSTC you can — without spending 
hundreds of dollars on expensive 
compilers. Now you can add win- 
dows, dialogs, and all the GEM forms 
to any program — it's easy with 
GSTC. Use your mouse and pull- 
down menus to write C programs 
within a desktop menu-driven 
"shell" environment. GSTC allows 
compile-assemble-Iink and assem- 
ble-link operations to be batched, 
avoiding tedious and error-prone 
command line entry. And it all fits on 



one single-sided disk. No excessive 
disk swaps. 

At the heart of the GSTC package is 
the remarkable GEM Superstructure 
Library. This enables the beginner to 
write GEM applications software at 
once, without the complex learning 
curve associated with GEM AES and 
VDI. Open a fully-functioning window 
with one call. GSTC is fast— providing 
compile and linkage turn-around times 
speedy enough for the most impatient 
hacker! 
GSTC features include: 

• GEM Text Editor 

• Linker 

• C Compiler 

• GEM "shell" 



• 68000 Assembler 

• GEM Superstructure Library 

• GEM bindings, (Standard Unix, GEM 
VDI, GEM AES, GEM XBIOS, TOS) 

• Comprehensive printed user manual 

ST0217 $79.95 

NOTE; We searched all over the world 
to find the best introductory C compiler 
When we discovered that GSTC was used 
to write 1ST WORD, we decided that it 
was just what we were looking for This 
compiler is very powerful and remark- 
ably easy to use. But at present, it doesn't 
have structures or a floating point library. 
If you're writing a program that uses very 
serious math, you may need to look al 
Lattice C. But if you're only writing a 
word processor, GSTC will do the job. 



I 



GST-LINK 

GST-LlNK is supplied with GSTC and 
GST-ASM and enables separately com- 
piled or assembled program modules to 
be linked together and to extract any 
run-time library routines from the GEM 
libraries. GST-LINK features include: 

• Relocatable, compact, binary format 

• Optional SID debugger symbols 

• Automatic run-time relocation of 
modules by the TOS loader 

• Comprehensive link map listing with 
optional symbol table 

• Optional global symbol cross reference 



" Link operations driven from a batch 

control fiie 
GST-LINK is the linker that Metacomco 
chose to use with all their products. 

FREEI With every GSTC and 
GST-ASM! 

GST-EDiT 

(Universal GEM Screen Editor} 
GST-EDIT is to programming, what 1ST 
WORD is to word processing, it's a GEM- 
based text editor which you can use for 
writing programs in any language that 



accepts ASCII files. If you know how to 
use 1ST WORD, you're already an expert 
with GST-EDIT. Its features include: 

• Up to four simultaneous files in 
separate windows 

• Block cut and paste between windows 

• Comprehensive search and replace 
functions 

• Cursor movement by mouse or 
keyboard 

• Full on-screen help information 

FREE! With every GSTC and 
GST-AMI 



GST-ASM" 



>■ A high-ievei Macro 

. Assembler with an 
unbeatable combination 
of price, performance, 
and features. 



GST-ASM is a Motorola-compatible 
68000 macro assembler with ad- 
vanced features — including high- 
level control flow instructions, very 
powerful macro facilities and ex- 
tremely fast throughput. GST-ASM is 
designed for the professional who 
needs a sophisticated macro assem- 
bler to develop real-time software 
products. And since it uses the GST 
GEM interface, it's a joy for begin- 
ner and intermediate programmers 
as well. 



GST-ASM features include: 

• 68000 macro assembler 

• Linker 

• GEM text editor 

• GEM ■■shell" 

• Unique, high-level instruction macro 
library (IF, WHILE, REPEAT CASE, 
etc.) 

• Generates relocatable code 

• Produces object code compatible with 
Lattice C, Meta Pascal, and Meta 
Assembler. 

• Comprehensive printed user manual 
STO218 $59.95 
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I ATTieif O' 

The standard for the 68000. 
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COMPILER 

. • FuUKemighanandRitchieimple- 

mentation 
■ • Powerful data types (pointers, 

arrays, structures, unions) 
" • Separate compilation 

• Conditional compilation 

• Macros 

• LATTICE design 

• IVue native code compiler 

• Comprehensive error handling, 
including warning messages 

• Full floating point arithmetic 

• Optimized to produce fast, com- 
pact code 

• No runtime licenses required 

• All C language features are sup- 
ported, including: 

PRE-PROCESSOR COMMANDS: 
^include, #def ine, #undef, #if, #ifdef, 
#ifndef, #else, #endif, #iine. 
STORAGE CLASSES: extern, 
static, auto, register, typedef. 
TYPE DECLARATORS: int, char, 
short, unsigned, long, float, double, 
struct, union. 



OBJECT MODIFIERS: ", [].(). 
Declarations may be arbitrarily 
complex. 

INITIALIZERS: Full range of ex- 
pressions accepted. 
SCOPE RULES: Identifiers may be 
redeclared at the beginning of any 
block, but all "extern" objects must 
be declared consistently within the 
same module. 

STATEMENT TYPES: All are sup- 
ported, including labels and goto. 
OPERATORS: All are supported, in 
the standard precedence, including 
conditional and comma operators. 

• Other features include comment nest- 
ing, variables up to 39 characters in 
length and separate name lists for each 
structure or union. 

• Full Text Editor 

' Complete Linker 

• 270-PAGE MANUAL 



• Use of the linker allows complete inter- 
face to GEM VDI and AES functions 
and to library of Unix and utility func- 
tions. Libraries are provided for com- 
plete interface to these functions, 
allowing all the features of the Atari 
ST— icons, windows, graphics, etc.— 
to be used. The graphics libraries are 
included in source code form to aid 
understanding and to allow the user 
to change the libraries (if required), 

• Compatible with two linkers. The ob- 
ject code produced by the compiler is 
compatible with both the linker sup- 
plied wit h the kit and also with L1NK68 
from Digital Research, 



ST0207 



$149.95 



Technical questions? Talk 
with a Metacomco System 
Software Engineer: Call 
(408) 438-7201. 
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Object Editor 



by The Rugby Circle 



NOW, the first all purpose graphics 
design programming package is 
available for the ST. An essential 
time-saving t«>ol developed for creat- 
ing software sprites and bit-mapped 
game objects. 

Your original art or favorite low-reso- 
lution picture from any ST paint program 
can be sketched or modified. Invert, twist 
or copy your objects. The zoom editing 
feature gives your picture that profes- 
sional look, Your object is stored on disk 
in a compatible format allowing you to 
access your work from tiie programming 
language of your choice. 



Store up to 20 objects in memory at once 
and instantly access four rainbow paint 
palettes from RAM. 

C.O.L.R. OBJECT EDITOR includes 
object motion examples. This is the only 
graphics programming tool of its kind 
for the professional and hobbyist 
programmer. 

See the November issue of ANTIC for 
more information on C.O.L.R. OBJECT 
EDITOR. 

"An all-purpose graphic design utility 
package for ST program designers using 
16-color mode." 

ST0201 $29.95 



DISK DOCTOR 




"Ssr/^^^ 



by Dan Matejka 

Learn the secrets of ST disk struc- 
ture, and if you're adventurous, try 
some "disk archeology." Recover 
deleted files automatically and re- 
pair damaged files and disks. Make 
quick modifications to any ST single or 
double-sided floppy or hard disk. Use 
DISK DOCTOR to customize program 
menus and messages. Search for char- 
acter strings or go to any sector instantly. 
Quickly edit full sectors on-screen using 
your mouse or cursor keys. Get direc- 
tory history, file attributes, and more. 
DISK DOCTOR is perfect for the casual 
user who just wants to repair a tile, OR 
the serious programmer who wants to 
discoverwhat'sreally going on. Includes 
on-disk Help and thorough technical 
reference information. 



ST0211 



$29.95 



Credit card holders, call toll-free, 24 hours-a-day orders 

B 800-443-0100, eXt. 133 (Continental U.S. and Hawaii) HI Of^LYI 
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RED 
ALERT 



Written by Stanley Crane 
and Daniel Matejka 

But you 
have some 
options. A 
few. Stra- 
tegically- 
placed Ground-Based 
Lasers and Antiballistic 
Missile Silos are ttie 
backbone of your de- 
fense. Your last space- 
based Particle Beam 
Weapon is available. 
but you must allocate 
your resources wisely 
to use it. 

NOTE: RED ALERT is an addicting game, but it's also a 
thought-provoking version of an SDI {Strategic Defense Initia- 
tive) nightmare scenario. (RED ALERT was developed by the 
authors of DB Master.) 










ST0223 



S24.95 



Your cities are underattack. It's up to you to try and destroy 
the Russian ICBM's and MIRV's— plus the missiles launched 
from nuclear subs. RED ALERT features real-time animation. 
on-screen help, auto-demo mode, color/monochrome compati- 
bility, three selectable levels of play, PLUS a unique construc- 
tion set which lets you customize North America with the cities 
that you want to protect, and the positions of the Ground-Based 
Lasers and Antiballistic Missile Silos. 



Create Ybur Astrological Chort 
Instantly Using Multiple House Systemsf 

STAR STRUCK 
—THE ASTROLO 

By Harry Koons and Dauid Chenette 

Now your ST can instantly generate accurate nat- 
al chiu-ts for you, your family, and friends—the 
way an astrologer would do it, Entirely GEM- 
based, THE ASTROLOGER creates charts based 
on the most popular types of house systems used 
tfiroughout history (Morinus, Equal Spaced, Porphory, and 
more). On-screen help windows show you exactly what all of 
the custom astrological icons mean. 




Thorough on-line documentation is available for reference. All 
aspectsaredisplayed in graphic form. U.S. and world maps are 
built into the program— locate your birthplace wit h the mouse 
or key-in the exact coordinates. Charts can be printed out or 
saved to disk in DEGAS format. Compatible with color and 
monocfu-ome monitors. 



ST0222 



$24.95 
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If you haven't heard about 

MURRAY or MOM yet, you 

haven't read: 

New York Times 

London Times 

Los Angeles Times 

San Francisco Chronicle 

MOM 



and ME" 



Just think. Your own computerized Jew- 
ish mother— on-screen in an overstuffed 
chair; knitting, cajoling, dispensing ad- 
vice, and offering you encouragement— 
or making you feel guilty, of course. 
MOM is a full-color, computerized, car- 
toon character always ready to chat. 
Dressed in granny glasses and fluffy slip- 
pers, she speaks to you by name and 
brags about you to your friends. 
MOM and ME uses extensive personality 
files for a wide variety of human-like 
responses, plus mouse-based response 
functions for easy interaction. 
ST0204 £34^5 

$19.95 this catalog only 
(monochrome/color) 



An Electronic Jewish 
mother created by a 
former Playboy 
cartoonist! 

Written by Yakov Kirschen 
and Just For You, Inc. 



On December 5, 1985 the NEW YORK TIMES chatted with 
MOM: 

MOM: Are you getting enough exercise, Tom? 

NYT: Vas Ma. 

MOM: By setting in front of the computer all day? 

NYT: No Comment. 

MOM: He's sulking agalnl Why don't you go out to a 

social function? Meet a nice girl. 
NYT: I'm married, remember? 
MOM: He's married, sorry, I keep forgetting. So how is 

what's-her-name? 
NYT: Change the subject. Ma. 
MOM: Mom was only trying to be polite, Tom. 
NYT: I know Ma. I know. 



MOM: Mom is not waiting for an apology. 

NYT: What or© you talking about? 

MOM: Insult m© as much as you want, Tom. Mom loves 

you. 
NYT: When did i insult you? 
MOM: I'm knitting a nice worm sweater for you, Tom. 
NYT: You're changing the subject. 
MOM: But you asked me to change th© subject. 
NYT: That was before. 
MOM: You see how your Mom remembers? 
NYT: What are you talking about? 
MOM: The sweater, Tom, the sweater. You're so forgetful. 

You get It from your father's side. 
NYT: Cut It out. Mat 
MOM: Mom has to go now, Tom. Be a good boy. 



MURRAY 
AND ME"* 



Some people don't want a Jewish 
mother. How 'bout a Jewish uncle? 

Meet MURRAY. The LONDON TIMES 
called MURRAY and ME, "the first in a 
new generation of Biotoons"— Living 
computerized, Interactive cartoon char- 
acters that use your Atari ST to create an 
artificial personality by using artificial 
intelligence programming methods. 
MURRAY is always ready to cheer you 



up when you're feeling blue (or take pot- 
shots at you when you're on top of the 

world). 

NOTE: Here are the first two titles in a 
whole new generation of Artificial In- 
telligence (Al) programs. These use a 
behavioral interface with the computer 
to illustrate how to teach a machine to re- 
spond differently to differing stimuli. 
MOM and ME and MURRAY and ME are 
the first steps towards an understanding 
of software behavior engines and arti- 
ficial intelligence programs. 

ST0203 $a4^S 

$19.95 this catalog only 
(monocrochome/color) 
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ANTIC ARCHIVES 



Mag 
^Progs/K No. 



Disk 
No. 



MAR ULTIMATE PRINTER GUIDE 8/61K AMS0385 ADS0385 
Feature Programs: KWIK DUMP (Best Graphics Dump), FONT 
MAKER, CUSTOM PRINT (for Aiati special char's, by Matt Rat- 
cliff). LABELMAKER, KEYBOARD MACRO COMMANDER, 
TWO BIG GAMES, and Secrets of Atariwriter, Printer Guide, XL 
Parallel Bus Revealed (part III) , . . 

APR COMPUTER FRONTIERS 10/87K AMS0485 ADS0485 

Feature Programs: S.A.M, SPEECH EDITOR, EIGHT QUEENS 
PROBLEM (Solution), PRICE'S PAINTER GETS FRIENDLIER, 
DOT MATRIX DIGITIZER, CRYPTOGRAPHY. MANEUVER, 
CRAZY EIGHTS!, and Welcome to ANTIC ON-LINE, Expert Sys- 
tems, XL Parallel Bus Revealed (part IVI. Profile: Nolan Bushnell 

MAY 3RD ANNIVERSARY ISSUE 10/86K AMS0585 ADS0585 
Feature Programs: SON OF INFOBITS (Database Editor), 
TSCOPE AUTODIALER, ARENA RACER, BEER PARTY ATARI, 
MODE MIXER, FADER II, AMAZING (Action! game), and ST 
tVleei the 6800Q. GEM overview . . . 

JUNE COMPUTER ARTS 10/173K ArVISD686 ADS0686 

Feature Programs: VIEWS-D, GRAPHICS UTILITY PACKAGE 
(For Atari BASIC), PICTURE ENHANCER, GUITAR TUTOR, THE 
MUSICIAN, HELICOPTER ROUND-Up TURBO TYPO II. and 
MIDI overview, Logo music, GEM Seminar coverage, Profile: Ron 
LuifS (SIG-Atari) . . . 

JULY COMPUTER CHALLENGES 8/145K AIV1S0785 ADS0785 
Feature Programs: 3 Puzzles (CRYPTOQUOTES, SLIDE, NAME 
THAT SONGI, 4 Arcade Games (STAR VENTURE, DARKSTAR, 
OVERFLOW, MINIATURE GOLF), and 130XE Bank Switching, 
Even^liing About Every DOS, Profile: Joel Billings (SSI) . . . 

AUG TELECOMPUTERS 9/117K AMSD885 ADS0885 

Feature Programs: ATARI 'TOONS (BBS Cursor Art), WETMORE 
ON THE 1030 MODEM, 1030 PROTERM. DISPLAY MASTER 
(Special Effects), VALLIANT, and ST SECTION I (Kermit Trans- 
fers, Interior View, Desktop Intro), Profile: The Microbils Boys 

SEPT POWER PROGRAMMING 10/60K AMS0985 ADS0985 

Feature Programs: BASIC REVISION C CONVERTER, 16-BIT 
MUSIC, 130XE ONE-PASS COPIER, MIRRORED DISPLAY 
LISTS, SOUND EFFECTS LIBRARY, FINE SCROLLING WORLD 
(Andrews, part I), 8 QUEENS ACTION!, PAGE FLIPPING, 
CRICKETS, and ST SECTION I! (1st Address Map, Using GEM 
Control Panel, Hi-res Art) . . . 



Mag 
It Progs/K No. 



Disk 
No. 



OCT MIND TOOLS 

Feature Progran 



8/54K AMS1085 ADS1085 
GRAPH 3-D, YOGA BREATHING, BANJO 
PICKER, ALIEN ASYLUM, LEMONADE (APX hit economics 
simualation!), FINE SCROLLING WORLD (part ID, and ST SEC- 
TION 111 (CD-ROM IN DEPTH, 1st ST Benchmark, GEfW COLOR 
Program), S.A.T Software Review . , . 

NEW COMMUNICATIONS 8/63K AMS1185 ADSllSB 

Feature Programs: MORSE CODE RECEIVER/TBANSLATER. 
RAPID GRAPHICS MODE CONVERTER, 130XE MEMORY 
MANAGEMENT MORE TYPO II ENHANCEMENTS. VAMPIRE 
RATS, FAST CURSOR MOVES, and Radio Modems and Soft- 
ware Overview. ST SECTION IV (ST Uses IBM Disl< Files, ST 
Sound) , . , 



DEC 4TH ANN. SHOPPERS GUIDE 6/71K AMS1285 ADS1285 

Feature Programs: DISKIO PLUS (Enhancements Plus 2.5 Com- 
patibilily), BBS CRASHBUSTER (Ratclif-f), BUILD YOUR OVJN 
EPROM BURNER, BOX-IN (J.D Casten), and 100 Best Atari 
Products, Profile: Lucasfilm Design Team, ST SECTION V (Intro 
To 520ST Assembly Ung.. ST LOGO Exploration, ST Products 
Guide) . . . 

3 JAN ATARI PRODUCT REVIVAL 7/63K AMS0186 ADS0186 

Feature Programs: APPOINTMENT CALENDAR, DUNGEON 
MASTER'S APPRENTICE. BINGO CALLER. SYSOP SANTA 
CLAUS, WIREBALL, and Mapping the XL/XE (Ian Chadwick). 
ST SECTION V! (ST FONT LOADER, TOS Roadmap. UK Soft- 
ware) . . . 

FEB PRINTER POWER 26/57K AMS0286 ADS0286 

Feature Programs: TSHIRT MAKER, INSTANTDOS, DOS 2.5 
FOR AXLON, MULTI-COLORED PLAYERS, WARRIOR 3000, 
1020 PLOTTER, BASIC ON/OFF SWITCHER. ST SEC V!l 
(FORTH ESCAPES, ST Disk Secrets, Crash Clues) 

MAR PRACTICAL APPLICATIONS 25/49K AIVIS0386 ADS0386 
Feature Programs: LIE DETECTOR, STICKWRITER, HOME 
HEARING TEST LUNAR LANDER CONST SET and Atari at 
WorIt, New Owners Column. ST SEC Vill (MiDI DRIVER, LOGO 
MODERNE, HIPPO SOUND). 

APR COMPUTER MATHEMATICS 17/46K AMS0486 ADS0486 

Feature Programs: FRACTAL ZOOM, GUESS THE ANIMAL, 
LIFE REVISITED, 3-D TIC TAC TOE, V(ERSiON) SAVER, and 
New Users Column part 2. ST SEC IX (3-D FRACTALS, ST Car- 
tridges. GEM and BASIC-VDI) 

MAY 4TH ANNIVERSARY ISSUE 17/68K AMS0586 ADS0586 

Feature Programs: MOLECULAR WEIGHT CALC, MYGARDEN, 
POSTERMAKER, JOYSTICK CURSOR. ROCKSLIDE, HEXCON- 
VERTER, and New Users Column Part 3. ST SEC X (JoySTick. 
ST PONG, and more). 



BONUS THE CASTEN GAME DISK 10/80K 



ADSOOOl 
iproved in- 



The fabulous games of J.D. CASTEN, updaied 
eluding some never before published: ESCAPE FROM 
EPSILON-I-, RISKY RESCUE (regular and INDUSTRIAL ver- 
sions), ADVENT X-5, BOX-IN, BIFFDROP (normal and NIGHT 
MARE versions), NEMESIS, CRAZY HAROLD'S ADROIT AD- 
VENTURE. 

ANTIC ST SECTION COMPENDIUM (SB0101 

A packed 3.5" disk! Includes object and source code for all ST 
programs in the August, '85 through January, '86 issues. Featur- 
ing FONT LOADER Desk Accessory (and a baker's dozen of 
fonts). SOUND.C (sound chip demo), COSINE (graphics), plus 
LOGO programs and some in-house code that's never been seen 
before. 

ANTIC ST SECTION COMPENDIUM II CSB0102 

Includes all programs from the ANTIC ST SECTION Feb 86 
through May 86, Featuring FORTH ESCAPES, MIDI DRIVER, 
HIPPO SOUND, LOGO MODERNE, 3-D FRACTALS, GEM AND 
BASIC, VDl, JoySTick and ST PONG 



5.00 each. Disks are S12.95 each. All Antic Archive progra 



e protected by international copyright laws and a 
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S/Terminal plus SOURCE! 

Gel on-line and transfer files with S/Termi- 
na!, a full-featured terminal program written 
in 68000 assembly language. S/Termlnal fea- 
tures Xmodem, Xon/Xaf^, 300/1200/2400 
baud support (and more, up to 19. 2K baud), 
and on-line help screen. ALL SOURCE 
CODE IS INCLUDED, in addition to object 
code. S/Terminal isdesigned forsuccessful 
Xmodem transfers under difficult conditions 
and will work with Compusen^e from foreign 
countries. This disk also includes several C 
source and object graphic examples, plus 
five LOGO demos. 
PDD057 $12.00 



ST BASIC/LOGO SAMPLER ^m 

BASIC: Includes Ml DIRECBAS -a simple 
MIDI sequencer and sample song files. 
BG.BAS- backgammon. Fractals in BASIC, 
Biorythm's, and more. LOGO; Nearly a 
dozen useful routines including complex 
graphics. Plus two bonus desk accessories. 
PD0078 $12.00 



ST DOODLE plus SOURCE 

The perfect GEM learning tool, PD paint pro- 
gram written in "C", including object and 
source files for you to explore. Works in all 
three resolution modes. Demonstrates GEM 
drop-down menus, windows, scroll bars, 
color selection, fill algorithm, three brush 
sizes. Comes with NEOVERT-converts 
your picturesfrom NEC to DOODLE format. 
Learn howGEM and the STwork . . .with- 
out any typing] 
PD0058 $12.00 



%»il 



DEGAS COMPETITION HI RES 
WINNERS 

The top eight monochrome entries from 
Batteries Included's DEGAS art competi- 
tion. Includes a slide-show viewing 
program — DEGAS is not required. 
PD0076 SI 2. 00 

DEGAS COMPETITION COLOR 
WINNERS 

The top eight color entries from Batteries In- 
cluded's DEGAS art competition. Includes 
a slide-show viewing program — DEGAS is 
not required. 
PD0077 $12.00 



"Learn about Fractals and GEIVI with 
"C" source code," 

ST FRACTALS plus SOURCE! 

Features MANDLEZOOM by Harry Koons. 
Uses Mandelbrot algorithm to draw fractals 
in GEM windows in any resolution. Then 
zoom in with 2 X , 4x, Sx , or 16x magnifi- 
cation. Change fractal iteration values and 
rescale fractals to enhance their color. Then 
save your fractal picture to disk. Includes all 
"C" source and object files. PLUS, a half 
dozen other fractal programs that use differ- 
ent algorithms and display techniques (some 
also with source code). 
PD0068 $12.00 



YOU NEVER 
GET A 
SECOND 
CHANCE 

at making a first impression, 
so give your graphics, letters 
or reports color that's worth 
remembering. 

Exciting things are happen- 
ing in the world of Atari 
graphics and data output. 




SOLID SOURCE CODE 

Features Jim Luczak's VDI SAMPLER and 
C PRIMER, which demonstrates C program- 
ming techniques and the use of VDI func- 
tions and their C BINDINGS. BICALC, a 
desk accessory Binary-Hexadecimal-Deci- 
mal calculator. Plus two very fast versions of 
LIFE, written in Assembler. All source and 
object code is included and is well com- 
mented. And morel 
PD0079 $12.00 



NOW you can odd 
the power of color 
to your printouts. All of 
our paper is 9V2" by 11" 
with "clean-edge" perfo- 
rations that tear down to 
a smooth 8y2" by ll'( 
We have colors and se- 
lections to satisfy the 
most discriminating cre- 
ative, professional and 
home user. 

Get ready to unfold 
the power of color! 
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